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ow, through a joint 
N development agree- 
ment, Symantec and 
Apple™ Computer let you 
produce the fastest Power 
Mac code. 
Symantec C++ for 
Power Macintosh™ now 
comes with MrC-— Apple's 


new optimizing compiler. 






Industry-standard 


Nullstone tests show that 





Code compiled using MrC runs an average of 22% faster than code compiled 
with the standard Symantec C++ compiler or Metrowerks Code Warrior 7'™* 


size and color. Organizing 
and navigating a project 
has never been easier. 

In addition, Symantec 
C++'s multi-threaded envi- 
ronment gives you the abili- 
ty to edit and write code 
while you compile. And 
our visual architect lets you 


quickly draw the interface. 






Corresponding code is then 





generated automatically. 


WHEN IMRC GOES TO WoRK, 
SYMANTEC C++ APPLICATIONS GET 22% FASTER. 





applications compiled with MrC 


run an average of 22% faster. 


DEVELOP FASTER 
APPLICATIONS FASTER. 


Not only can you develop the 
fastest Power Mac applications, 
you can write them fast, too. 
New AppleScript support lets you 
automate repetitive tasks. While 
the new linker provides fast turn- 
around for incremental builds. 

With the fully integrated 
class browser, you'll quickly nav- 
igate your C++ class library. 
And support for templates and 
multiple inheritance further 


boosts your productivity. 


ORGANIZE AND MANAGE 
PROJECTS EASILY. 


The new Project Manager 





lets you organize and manage | 


nested projects. You can —@ 
display hierarchical 
groups as folders within a § 
project window for easier | : 


organization. 


The editor gives you = - _ 


unlimited split panes and 


full text formatting— font, ~ 


MRC COMPILER 
produces the fastest Power Mac applications 


APPLESCRIPT 
automates the build process 


NEW INCREMENTAL LINKER 
provides fast incremental builds 


TEMPLATE AND MULTIPLE 
INHERITANCE SUPPORT 


increases productivity 


NESTED PROJECTS AND FOLDERS 
let you organize and navigate projects 


MULTI-THREADED 

_ ENVIRONMENT 

lets you edit and write code while compiling 
VISUAL ARCHITECT 

___ builds your interface visually 








All in all, Symantec C++ is a 
great way to develop the 
fastest applications for 


Power Mac. 


THREE GDS FOR THE 
PRICE OF ONE. 


When you register as a 
Symantec C++ owner, 
youll be enrolled in the Symantec 
C++ Subscription for Macintosh 
program. Subscribers will auto- 
matically receive two free prod- 
uct updates (on CD ROM) so 
youll always have the latest fea- 
tures and tools. 


Learn more about Symantec C++ on 


the Internet at www.symantec.com 
Or call 1-800-628-4777, Extension 


9H122 for more information. 
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Offer valid in U.S.A. only. *Industry standard Nullstone Tests run 9/29/95 on Power Mac 6100/60. For more information in Canada, call 1-800-365-8541. In Australia, call 2-879-6577. In Europe, call 31-71-353111. 
Symantec is a registered trademark of Symantec Corporation. All other trademarks are the property of their respective holders. All rights reserved. © 1995 Symantec Corporation. 

















Hungry For A Productive Development 
System For Delivering Solutions? 





SmalltalkAgents”® Brings The Right Tools To Your Table. 


# Dynamic environment with incremental @ 8/16/24 bit international character support 
complling # Platform Independent Portable Objects 

Fully styled source code with fonts and color (PIPO) 

# Inline foreign function callbacks to C, # Easy to create stand alone application with 
Pascal, Fortran and Assembly royalty free delivery 

@ Preemptive interrupt driven threads and @ Cross platform develooment with full 
events support of native OS functionality 


Distributed system capability support 










A new generation of Object-Oriented Programming based on a 
superset of the Smalltalk language. 


We offer a 30-day money-back guarantee. For more 
information, including platforms availability, 
call us toll-free today. 


UK 


Quasar Knowledge Systems e 9818 Parkwood Drive # Bethesda, Maryland 20814-4028 USA e Phone: 301-530-4853 @ Fax: 301-530-5712 


© Quasar Knowledge Systems, Inc. 1993 All Rights Reserved. All other brand or product names are trademarks or registered trademarks of their respective holders. 











For Macintosh 
Programmers & Developers 





M oA G A Z IN & 
A publication of XPLAIN CORPORATION 





How To Communicate With Us 





In this electronic age, the art of communication has become both easier and more complicated. Is it any surprise that we prefer e-mail? If you have 
any questions, feel free to call us at 805/494-9797 or fax us at 805/494-9798. 
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By Dave Mark 








More Java Basics 


Last month, we started exploring Java, 
Sun’s object-programming language that 
has exploded in popularity over the last 
year. As a reminder, Java is similar to 
C++, but with some very important 
differences. The Java syntax is just like 
C++, but without the pointer syntax. 
The Java environment that runs on your 
machine is multi-threaded, with a low- 
priority thread that does automatic 
garbage collection. 

Your Java source code will reside in 
a file ending with the . java extension. 
Your Java source code will implement a 
class, or a series of classes. Depending 
on your development environment, you 
will compile the classes into a stream of 
Java byte-code, which will get stored in 
a .class file, in a series of .class 
files, ina .zip file, or, in some cases, in 
a double-clickable application file. 

The .class file is designed to hold 
a single class. If you build a bunch of 
.class files, you could pay a severe 
penalty in wasted hard drive space. For 
example, my 1-gig hard drive has a 
minimal file size of 17K. If I build 100 
.class files, each of which is filled with 
100 bytes of byte-code, I'll end up using 
1700K of hard drive space to store 10,000 
bytes of byte-code. Not very efficient, eh? 

The solution to this problem is the 
.zip file. The .zip lets you combine 
a set of classes into a single file of byte- 
code. Since the .zip format is based 
on the .zip compression format from 
the PC universe, you can use a zip 
utility dike UnZip) to peruse the classes 
ina .zip file. 

To run your byte code, you'll need 
a byte-code interpreter. There are 
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several options for doing this. Your development environment 
most likely came with some form of Java virtual machine. It 
might be called “javai”, “Applet Runner”, “Applet Viewer”, or 
something else. The point is, the virtual machine knows how 
to turn your generic Java byte-code into the equivalent machine 
code specific to your platform. There are Java virtual machines 
written specifically for the PowerMac, and Java virtual machines 
written for 680x0, x86, and Unix platforms as well. The first 
virtual machines came from Sun. Other vendors are writing 
their own. Check with your development environment for 
details on your virtual machine. 


JAVA REFERENCE BASICS 
Our first Java program this month demonstrates an important 
and potentially confusing difference between Java and C++. As 
stated earlier, Java doesn’t support pointers. When you create 
an object, the variable you associate with the object instance is 
known as a reference. This example should make this clear. 

If you are using CodeWarrior or Caffeine, create a new 
project file using the appropriate Java stationery. I’m using the 
CodeWarrior droplet stationery, so my project was named 
reference.u. 

The CodeWarrior environment ships with a bunch of 
stationery, including one for Java applets and one for Java 
droplets. The Java applets stationery lets you create an applet 
designed to be launched from an HTML file. This is pretty 
standard stuff and will be supported by most every Java 
development environment you run into. 

The droplet stationery is both cool and different. It lets 
you turn your Java code into a standalone application, complete 
with 4-byte creator code and its associated 'BNDL' resources. 
And if you drop a file or set of files onto the droplet, the names 
of the files get passed to main() via the argv parameter. I'll 
present a small example of this later in the column. 

Once your project file is set up, create a new source code 
file named reference. java and type this source code into 
the file: 


public class reference 
public static void main( String argv[] ) 


String sl = "Sample String"; 
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Each year, the illegal use of software 
consumes nearly 50% of your potential 
revenues. With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained Illegally, by region, 1993 vs. 1994 


$666,440,105 
392,687,055 


NUE eee araliyila wr 


Software Piracy 
Burns Your 
Profits. 










ao 

Africa/Middle East 
$3,963,527 ,364 

4 350,981,640 








_—_ $4,900,882,960 
s 6,002,681,255 





$821 ,992,751 
1,334,894,665 





$2,487 ,360,944 
3,131,455,600 





U.S /Canada 
$12,840,204,124 


Total for 1994: $15,212,700,215 Source: BSA 





MacHASP® is widely acclaimed as the world’s 
most advanced software protection solution 
for Macintosh computers. Since 1984, 
thousands of leading Mac and PC developers 
have used over one million MacHASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Because MacHASP’s 
security, reliability, and ease-of-use led them 
to a simple conclusion: MacHASP is the most 
effective software protection system available. 








Today, more developers are choosing 
MacHASP than any other software protection 
method. To learn why, and to see how easily 
you can increase your revenues, call now to 
order your MacHASP Developer’s Kit. 


1-800-223-4277 





The Professional's Choice 


North Aladdin Software Security Inc. 
America Tel: (800) 223 4277, 212-564 5678 
Fax: 212-564 3377 
E-mail: sales@hasp.com 
WWW: http://www.hasp.com/ 


Intl Office Aladdin Knowledge Systems Ltd. 
Tel: 972-3-537 5795, Fax: 972-3-537 5796 


VISIT OUR WEB SITE E-mail: aladdin @aladdin.co.il 


http://www.hasp.com/ United Aladdin Knowledge 
Kingdom Systems UK Ltd. 
Tel: 01753-622266, Fax: 01753-622262 


France Aladdin France SA 
Tel: 1 40 85 98 85, Fax: 1 41 21 90 56 





© Aladdin Knowledge Systems Ltd. 1985-1995 (6.95) HASP@ is a registered trademark of Aladdin Knowledge Systems Ltd. All ae product names are trademarks of their respective manufacrurers. Mac & the Mac OS logo 
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object-oriented database engines availa 








Powerful 
NeoAccess and NeoShare are the most powerful 
ble. They 
display electrifying performance—up to ten 
times that of competitors. Behind an elegant 
jeyueycaucvanbeetiarcanaltaur:(@om ceWeltudemeaeceuirinac 
query engine utilizing: extended binary trees 
and binary search algorithms tuned for short 
access times, dynamically combined, collapsed, 
and compressed indices, and object caching for 
lightning fast access to eel used objects. 


No Runtime Fees 

Get the power of NeoAccess and avoid the 
expense and administrative hassle of feeding the 
runtime fees meter. You pay one affordable price 
reomsentelaccaum eteyyraent-lay were) py(cMe) Mp ycoleuarcypyp)iezluTeye) 
you sell or use. 





Scalable 


NeoShare extends the core features of 
NeoAccess to client/server applications. 
NeoShare includes the NeoAccess Toolkit and 
everything you need to create data intensive 
distributed applications. Its advanced 


client/server architecture provides shared access 


to objects by multiple inter- and intra- 
networked clients. Combine client and server 
jauyatelaoyal-weelcem-mcstared(ou-lo)o) tle leleeMeymener:ttc 
separate client and server applications. With 
NeoShare you have complete flexibility in the 
design of your distributed systems. 





Power Too Abundant to Meter! 


Cross Platform | 
Others may promise cross-platform 
development tools—NeoLogic delivers. 


_ NeoAccess and NeoShare consists of C++ classes 
_ designed for use with popular compilers and 


application frameworks on Windows® (3.x, ‘95 
and NT), Macintosh® (M68k and PPC), and 


Unix™ (all flavors) platforms. Full source code is 


available so both products can even be used 
with custom frameworks. 


New in NeoShare Version 2.0 


} 


} 


Cross-platform and internet-savvy NeoShare 2.0. 


is now shipping! NeoShare extends standard 
application frameworks including; Metrowerks' 
PowerPlant, Symantec's THINK Class Library 
and Apple's MacApp on the Macintosh, and ~ 
Microsoft's Foundation Classes and Borland's 
OWL in Intel-based environments. 


Proven 

sUatelerrvetecne) meoyentenlaceclacvelemlerselelnse 
developers have already found that NeoLogic’s 
technology enabled them to build fast, 
tied eta icoated olar-velely olen vcosiblar-loyo)elervuleyatsutem nee) cel 
time. That's why NeoAccess and NeoShare 
lostcxeur-Yoyo)e(e-laCeelcm-vcomelinar:Cebvaco) o(cie-lalercaeyel 
millions of computers. Tap into the power for 
yifelebuselo.curelaraleyeyeetaslaneyee)(ceaa am 


neoslogic 
Powering Development of Object-Oriented Applications 


NeoLogic Systems 1450 Fourth St., Suitei2_—-v. 510.524.5897 
neologic@neologic.com Berkeley,CA 94710 _ f. 510.524.4501 
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String s2 = "Sample String"; 
String s3 = new String(sl); 


a { sf == 37) 

System.out.printin( "sl is the same object as s2" 14 
else 

System.out.printin("sl is not the same object as s2"); 


if ( si == 63) 

System.out.printin( "sl is the same object as s3" ); 
else 

System.out.println("sl is not the same object as s3"); 


Compile and run the program. Here’s the results you 
should see in your stdout window: 


sl is the same object as s2 
sl is not the same object as s3 


Let’s take a walk through the source. These three lines 
declare references to String objects: 
SLEing 21 "Sample String"; 


String s2 = "Sample String"; 
String s3 = new String(sl); 


The first line creates a reference named s1 and also 
creates a new String object, initializing it with the literal 
“Sample String”. The second line also creates a reference, this 
one named s2. The question here is, was a new object 
created? The answer is no. The compiler checks to see if a 
literal with the value “Sample String” already exists. Since such 
a literal does exist, the compiler doesn’t bother creating a new 
one. It just creates the new object reference (s2) and makes it 
refer to the original literal. Since there is no way to modify a 


literal, this strategy is pretty sure-fire. Since pointers don’t exist. 


in Java, the compiler has more freedom in allocating memory 
for objects. 

The third line of the set uses new to force the allocation of 
a new String object. The String reference s1 is passed as a 
parameter to the String constructor. So we end up with 
three String references: s1 and s2 both refer to the same 
String object, and $3 points to a second String object. 

To verify this theory, the first if-else statement uses the == 
operator to test if s1 is the same as s2. Note that this tests 
whether sl and s2 refer to the same object. As proof, the 
result of the first if-else is: 


sl is the same object as s2 


The second if-else compares s1 to s3. Since we used 
new to force the allocation of a new String object, it is no 
surprise that the second if-else produces this result: 


sl is not the same object as s3 


Take a few minutes to review the String methods; you'll 
find them in the API Documentation folder in the file 
java.lang.String.html. Pay specific attention to the 
compareTo(), equals(), and equalsIgnoreCase() 
methods. 
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COPYING AN OBJECT 


Before we move on to our second example, let’s talk about 
copying objects for a moment. I was reading through my pile 
of Java books when I noticed an interesting discrepancy. 
Several of the books specified that to duplicate an object, you 
should use the copy() method, inherited from 
java.lang.Object. Alternatively, some sources 
recommended that you use the clone() method, also 
inherited from java.lang.Object. 

Being a curious son-of-a-gun, I wheeled over to Netscape 
and opened up java.lang.Object.html (in the folder API 
Documentation) to look for clone() and copy(). As it turns 
out, copy() isn’t there and clone() is there, but marked as 
protected and couldn't be called from our main() class above. 

So what the heck was going on here? After a few phone 
calls and emails to my Java buddies, I found out that copy () 
was dropped from the Java API between beta 1 and beta 2 of 
Java. I also found out that the clone() method was changed to 
protected and that a new interface (we'll talk about Java interfaces 
in a future column) was created, called the cloneable interface. 
Basically, if you want your objects to be cloneable, they need to 
implement the cloneable interface. To learn more about this, 
check out the file CloneNotSupportedException. html and 
this URL: http://java.sun.com/JDK-beta2/changes.htm| 

The point of all this isn’t to push the cloneable interface. I 
was just trying to save you from going through the head- 
banging exercise I just went through trying to figure out why 
copy() and clone() weren’t working as they were described 
in the books. But if you want to learn how to make your 
objects cloneable, well, go right ahead... 


While we are on the subject of problems you'll 
probably run into, we should definitely cover the topic of 
long file names. Since Java grew up in the Unix world, it 
naturally took advantage of the fact that there is no limit 
to the length of a Unix file name. The problem is, 
Windows 3.1 and DOS file names are limited to eight 
characters (with a three-character extension) and Mac 
filenames can be no longer than thirty-one characters (’m 
not sure what the limit is on Windows95 file names, but I 
think it is thirty-one as well). 

Bottom line, the long Java file names periodically 
exceed the limits imposed by non-Unix operating 
systems. It is not clear exactly how all this will shake out, 
but you need to be aware that some file names will 
change between Unix and the Mac. Before you buy a 
development environment, ask the vendor how they deal 
with this problem. 
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The Right Tool for ; 
Video Compression 


If your project includes QuickTime movies, you need Movie 
Cleaner Pro, the most powerful and easy-to-use video compression 
tool available. Now you can quickly compress movies for CD- 
ROM or the Web — with unparalleled quality and speed! 


Features include: 


Drag & Drop Batch Processing - easily create 
a batch of up to 2,000 movies in minutes. 


Terran Interactive 


Automated IMA audio compression and high 


quality audio resampling for great sound. Movie Cleaner Pro 1.2 


Suspend and Resume - stop compressing and 
then flawlessly resume - even for batches. 


Advanced Settings - easily adjust data rates, 
A/V fades, high-quality frames, and more. 


Adaptive Noise Reduction filter, high quality 
sine image scaling, and much more! 


77-3443 


)8) 278-9065 
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== Preferences = 


Project Type: Droplet v 


sued Paths Class: Helloworld - i a 
xtras fHeloWorld 
~] Optimize for speed Type 


[] Verbose output Creator 
><] Report warnings 





A Quick DROPLET 

Our second example is a droplet, built using CodeWarrior. 
Basically, the droplet is an application that sends the embedded 
classes to the virtual machine. If any files are dropped on the 
droplet, their names are sent to main() in the argv parameter. 

To create a droplet, create your project using the droplet 
stationery. Copy the resource file from the example 
“HelloWorld” droplet and edit it to change the creator signature 
and signature resource. Next, edit the project preferences to 


Ei Moke JAVA BASsICcs 


reflect the application’s file name, the name of your class, and 
your creator (Figure 1). 

Here’s the droplet source code for the Hello droplet (note 
that the class is called HelloWorld but the droplet is called 
Hello): 


public class HelloWorld 


public static void main(String argv[]) 
if (argv.length == 0 ) 
System.out.println("You launched Hello " + 
"without dropping anything on it."); 
else 
{ 
System.out.println("You launched Hello " + 
"dropping the following things:"); 


Porlint 1 = 0; dsarey, lenetis att) 
System.out.printin("Arg[" + 
c+ Vi=* > aregta| ps 


Basically, this code prints one message if the droplet is 
launched without any files dropped on it, or else prints the list 
of files dropped on the droplet. 

Here’s the result of launching the Hello droplet without 
any files dropped on it: 


You launched Hello without dropping anything on it. 


Here’s the result when I dropped three files on the droplet: 


You launched Hello dropping the following things: 
Arg [0]=/Macintosh%20HD/Test%20Files/Filel 
Arg [1]=/Macintosh%20HD/Test%20Files/File2 
Arg[2]=/Macintosh%20HD/Test%20Files/File3 


Note that the %20 in the string represents ASCII character 
32, which is the space character. 20 in hex is 32. 


OUR First APPLET 
Before we go, here’s a taste of things to come: our first official 
applet. As mentioned in last month’s column, a Java applet is a 
Java class that is derived from the class java.applet.Applet. 
The java.applet.Applet class is described in the file 
java.applet.Applet.html. Take a few minutes to look 
this page over. 

Our first applet takes advantage of the packages 
java.awt.Graphics and java.awt.Font. Take a few 
minutes to look over the files java.awt.Graphics.html 
and java.awt.Font.html. In fact, it is probably a good 
idea to look through the files in the API Documentation just to 
get an idea of what is in there. 

Our applet will consist of a single class, called hello, and 
a single method, called paint(). Our paint () overrides the 
standard paint() method that is part of the standard applet. 
The default paint () method does nothing. Ours will use a 
sequence of AWT (the Java equivalent to the Mac Toolbox) 
calls to draw the string “Hello, world!” in a pane or in a 
window (depending on the browser). 
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Announcing 





Why so many developers are switching to 
MicroGuard copy protection 


@ MicroGuard is committed to uncompromising 
technological superiority 
"Technology at its peak" is our commitment to you. That is why we have 
brought you MicroGuard Plus™. And, MicroGuard Plus is 100% 
backwards compatible with MicroGuard. This means MicroGuard 


and MicroGuard Plus can be used interchangeably. 
Just as we promised! 


® MicroGuard offers you the 
most sophisticated network 
protection 


Our network protection, MicroGuard Net™, 
is so superior, we had to hire an Apple network 
engineer to execute our specifications. 


@® MicroGuard is the only key 
developed by Mac 
developers, and is the first 
and only 100% ADB savvy key 


We have been developing Mac applications as a seed development house 
since 1984. We are not a PC protection company that has come to you 
with a Mac product. MicroGuard is fully ADB savvy and offers extended 
addressing. Unlike other protection devices, MicroGuard never clashes 
with other keys. Only MicroGuard offers this level of sophistication. 







For more information and to order a Developer's Kit or to receive a free CD ROM about MicroGuard, 


please contact us at: 


MicroGuard USA: Tel: (303) 320-1628 
International: 





(actual size) 


© Fax: (303) 320-1599 
Tel: (972) 3 558-2345 ® Fax: (972) 3 558-2344 ° AppleLink: MICROGUARD 


@ MicroGuard has now surpassed its own 
technological lead, actually improving on the best 


MicroGuard Plus is everything MicroGuard is, plus 40-bit encryption, two 
additional passwords, 64-Bit Array, 32-byte public area, 45% size reduction, 
enhanced counter and more. In addition, MicroGuard Plus offers two new 
utilities: QuickGuard™ and EasyGuard™ allow you to protect your 
applications without touching your 
source code. The only feature that 
is not plus is the price. :-) 





MicroGuard is the best 
selling Macintosh key in 
the world 


MicroGuard sells more Macintosh 
copy-protection keys than anyone else 
in the world! 





® MicroGuard delivers 
developer support 
within 24 hours 


We will answer any inquiry you have within 24-hours. We also have a fully loaded 
AppleLink bulletin board which contains all our libraries, tech notes, Q&A and 
nearly everything you'll ever need! 





¢ AppleLink: MtGUARD 


Pirate Busters 


MacOS 








JAV 


MACINTO 


Macworld - May ‘96 


orders: (800) 739-1616 
email: orders@natural.com 
web: www.roaster.com 
International: (617) 556-2588 





www.natural.com, info@natural.com 


Roaster is a trademark of Natural Intelligence, Inc. All rights reserved. Copyright © 1995-1996 Natural Intelligence, Inc. and its licensors. Macintosh 
isa registered trademark of Apple Computer, Inc. Mac is a trademark of Apple Computer, Inc. Java and Sun are trademarks of Sun Microsystems, 
Inc. All tradenames referenced are the trademark or registered trademark of their respective holders. 











Here’s the source code: 


import java.awt.Font; 
import java.awt.Graphics; 


public class hello extends java.applet.Applet 
{ 
public void paint( Graphics g ) 
{ 
Font f = new Font( "Chicago", Font.PLAIN, 36 ); 


g.setFont( f ); 
g.drawString( "Hello, world!", 0, 30 ); 


Notice that we don’t have a main() in our class. Instead, our 
class follows the standard established for applets. The paint () 
method will be called when it is time to draw our applet. The 
Font object will be created using the Chicago font and is set to 
plain 36 point. The Font object is passed to the setFont () 
method, making that font, style, and size current for the 
Graphics object g. Next, the string “Hello, world!” is drawn in g 
at the coordinates (0, 30) using the method drawString (). 

To run this applet, you'll need to first compile the source 
code into a class file (I called my class file hello.class) and 
then build a bit of HTML to launch the applet. Here’s my HTML 
code: 
<title>My test applet...</title> 
<hr> 


<applet code="hello.class" width=250 height=35></applet> 
<hr> 


Of course, you might want to add more to your HTML, but 
this should do the trick. Save the code as hello.html, and 
be sure hello.html and hello.class are in the same 
folder. Now drag hello.html onto your applet runner. 
Theoretically, you should see something like the window 
shown in Figure 2. 





Figure 2. Running the applet using CodeWarrior 


Tutt NEXT MONTH... 


To me, having the advanced windowing toolkit (AWT) is like 
having a copy of PowerPlant or the TCL. The framework takes 
care of all the administrative detail so I can concentrate on 
filling in the details. In next month’s column, we'll do just that. 
We'll poke around the nooks and crannies, exploring the AWT. 
See you then... 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 









“A distinct improvement over ResEdit.” 
— MacTech /| MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


”*Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
~— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“.a wealth of time-saving tools.” 
MacUser Review, Dec. 1992 


RESORCERER 
Version 1.2.4 The Resource Editor for the Macintosh Wizard 


ORDERING INFO e New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pltt’, ‘clut’ editors 
¢ Powerful icon family editing (all 9 icon types) 
e Color pixel anti-aliasing, dithering, and lots more 
Needs: >Mac Plus, > Sys 4.2, 1MB e Complete ‘PICT’ disassembly and reassembly 
Likes: >Mac Plus, > Sys 7.0, 2MB New 1.2 Features: ¢ sopra sare ROM absent browsing bad 

as Try ° emplate field parsing types now supporte 
22-bit clean, AUS compatible e New insertion & deletion template field types 

_ e Text-only ‘PICT’ resources 

e Lots of improvements throughout 


Price: $256 (decimal) : | 
(Educational, quantity, or 
_ other discounts available) 


e Easier, faster, more Mac-like, and more productive than ResEdit 
a e Safer memory-based, not disk-file-based, design and operation 

- Includes: 500 page manual e All file information and common commands in one easy-to-use window 

60-day Money-Back Guarantee e Compares resource files, and even edits your data forks as well 

Domestic UPS ground shipping e Visible, accumulating, editable scrap 

e Searches and opens/marks/selects resources by text content 

¢ Makes global resource ID or type changes easily and safely 

¢ Builds resource files from simple Rez-like scripts 

e Most editors DeRez directly to the clipboard 

e All graphic editors support screen-copying or partial screen-copying 

e Hot-linking Value Converter for editing 32 bits in a dozen formats 

e Its own 32-bit List Mgr can open and edit very large data structures 

e Templates can pre- and post-process any arbitrary data structure 

| @ Includes nearly 200 templates for common system resources 

Downloadable Demos/Updaters: ¢ TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCH, GX, etc. 

AppleLink: Software Sampler | © Full integrated support for editing color dialogs and menus 

AOL: Software Libs/Development ¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 

CompuServe: MACDEV/Tools e Integrated single-window Hex/Code Editor, with patching, searching 
ees 3 e Editors for cursors, versions, pictures, bundles, and lots more 

e Well-designed, helpful developer tools being added all the time 

° Relied on by thousands of Macintosh developers around the world 


Payment: Check, PO's, or Visa/MC 
Extras (call us): 


COD, FedEx, UPS Blue/Red, 
International Shipping 


or call us. 





MATHEMASSTHETICS, INC. 
P.O. Box 298 * Boulder * CO ® 80306-0298 * USA 
Phone: (303) 440-0707 © Fax: (303) 440-0504 
AppleLink/AmericaOnline: RESORCERER ° Internet: resorcerer@aol.com 








~ Codewarrior and 
_ Symantec v versions now 
_ available! 
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Motorola’ S optimizing ClCae SDK, | . 
PowerPC Edition for Mac OS, is Rete cprciiically | 
for developers creating applications and tools for computer systemsrunning 
Mac OS. The Motorola compiler works with Metrowerks CodeWarrior, Symantec C/C++ and Apple Macintosh 

Programmer's Workshop (MPWe) to offer a powerful set of development tools within a complete development environment. 


The SDK features the Kuck & Associates Preprocessor (KAP™) — a powerful code restructuring tool designed to improve 
performance across a broad range of application programs. The Motorola C/C++ SDK delivers world-class code oy olubenbyzctareye 
for any specific PowerPC microprocessor, while ensuring compatibility across the entire PowerPC family of microprocessors. 


Call 1-800-347-8384 or 1 -512-891-2999. © 1996 Motorola, Inc. All rights reserved. Motorola and @ 


are registered trademarks of Motorola, Inc. PowerPC is a 
ite-lel-leat-la. @em | =}\'/mOve)g om MMOL -Te MUTate(-Tal(eclals-Mtalcleciinelaay 


Internet: ppcinfo@risc.sps.mot.com — http://www.mot.com/PowerPC/ All other trademarks belong to their respective owners. 
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By John R. Powers, II, guide Works, LLC 








Apple Guide Authoring Tools 





Helping you belp users 
help themselves 


In an earlier article (MacTech Magazine 
12.1 [January 1996] 67-70), we reviewed 
three new books about Apple Guide 
authoring. Now we'll focus on the tools 
for Apple Guide authoring. The January 
article also contains a brief introduction 
to Apple Guide in case you need to 
brush up on your guide terminology. 

The original Apple Guide authoring 
tool is Guide Maker. Two new tools 
have arrived. They are Danny Goodman’s 
Apple Guide Starter Kit and StepUp 
Software’s Guide Composer. We'll 
examine all three tools in this review. If 
you are new to guide authoring, the 
review may help you to decide where to 
start. If you’re an old hand at it, the 
review may help you to decide what to 
use next. 

But first, we will give you a quick 
overview of the Apple Guide authoring 
process and how these tools fit in. 


THE AUTHORING PROCESS 

To create a guide, this is what you 

usually do: 

e Task analysis. Identify and articulate 
the tasks that the user must 
accomplish. 

e Instructional design. Specify how 
the guide will support the user’s tasks. 

¢ Content writing. Create the words 
and images to support the instructional 
design. 

e¢ Scripting. Mark up the content with 
Guide Script. This includes identi- 
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fying topic areas, index terms, the formatting and 
sequencing of content, context checking, and automation. 

¢ Application integration. Add Apple Guide-specific code 
to the application. This is an optional step. 

¢ Testing. Test guides as a part of the application test suite. 

¢ Localization. Adapt the guide to serve an international market. 


The authoring tools primarily support content writing and 


scripting. Guide Maker requires that you write your content and 
do your scripting with a word processor. Guide Maker takes the 
word-processing documents and compiles them into a guide. 
The Starter Kit and Guide Composer replace the word processor 
with WYSIWYG content entry. Scripting is done by the tool. In 
addition, the new tools use a new, streamlined version of Guide 
Maker called Guide Maker Lite for seamless compiling. Figure 


1 shows how the tools are used for authoring a guide. 


Word Processor 


“a 


Write content l Apple Guide 


Starter Kit | Guide Composer 


Content  ] uN 


A a aa 


Add Guide Script J — — — — automatic 


Content and 
Guide Script 


Guide Maker or 


Ponpeeanoen ye Guide Maker Lite 





Figure 1. Authoring a guide 
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Guide Script 

Underlying the process is Guide Script. It is a mark-up 
language that identifies Apple Guide elements, controls content 
layout, and sequences panels. There are about 100 commands in 
Guide Script. The language is a combination of definitions, 
content layout, and panel sequencing. It’s like “HTML meets 
MPW”. If you are uncomfortable with programming, you may 
have serious difficulty learning Guide Script. Even scripting-savvy 
technical writers find the learning curve to be frustratingly steep. 


GUIDE MAKER 
Guide Maker is the original authoring tool developed by Apple 
for Apple Guide. It’s five tools in one: build guides, test the 
look-for search, run and diagnose guides, convert WinHelp to 
Guide Script, and import/export text for localization. We'll 
consider only the “build guides” part here. 

This is the granddaddy of all the Apple Guide authoring 
tools. Guide Maker and its leaner, faster offspring, Guide Maker 
Lite, are the only tools that can compile guides. And they only 
compile help content marked up with Guide Script. Until Apple 
releases a public API for reading and writing guides, we must 
use Guide Maker or Guide Maker Lite for compilation. 

Guide Maker produces the most complete set of Apple 
Guide features. It’s the reference point for any new authoring 
tool. So if it does everything, why consider something else? 
There are lots of reasons, but the biggest one is the fact that 
you are required to know Guide Script. 

Guide Maker itself can make the process difficult. Any 
error in the Guide Script syntax usually stops compilation. You 
fix the error and then start compilation from the beginning. 
There is no incremental compilation. If you have a large guide, 
compilation can go for many minutes before encountering an 
error and stopping. This iterative process of compiling, 
encountering errors, fixing errors, and restarting the com- 
pilation is frustrating and time-consuming. 

Guide Maker requires text files as its input. This 
introduces problems in managing the Apple Guide elements 
and visualizing the final output. 

In Apple Guide, everything is related to something else. 
For example, topic areas are related to topics which are related 
to sequences which are related to panels. This is shown in 
simplified form in Figure 2. 


Topic Area Topics Sequence 


(oo. 


| Panel Panel 


Je te 


Figure 2. One example of the relationship of Apple Guide elements 


Each of the four elements — topic area, topic, sequence, and 
panel — is authored separately and linked to another by 
referencing its name. It’s up to you to come up with meaningful 
names and keep track of all the elements. In a reasonably large 
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guide, this can involve many hundreds of elements, a difficult 
management job for any author. Unfortunately, Guide Maker 
provides no support for managing all the elements. 

Visualizing the final output is another difficulty. Using a 
word processor, you program the sequence of panels in a topic 
and specify the formats for how the panel content is to be 
displayed. When the user views the guide, Apple Guide 
creates a layout by “flowing” the content into the panel 
according to your formats. The layout process occurs at 
display time to allow for automatic adjustment of the panel for 
localized text. German, for example, requires more panel 
space than English, to accommodate its larger words. Apple 
Guide handles this text expansion at runtime. However, a 
word processor may not display the help content in the same 
form as Apple Guide. As a result, you must visualize what the 
help content will look like. If you are used to WYSIWYG 
writing, you may be frustrated. 

Listing 1 shows an example of how a panel is written in Guide 
Script. The be ane Guide panel is shown in Figure 3. 





Listing 1: “Apple Guide panel written in Guide Script 


<Define Panel> "What is it - panel 1" 

<Format> "Tag" 

<PICT> 2997, RIGHT 

<Format> "Body" 

The guideWorks Translator creates a WinHelp project from your 
Apple Guide source files, which you can compile into a 
WinHelp help file using the Windows Help Project Editor. 

<End Panel> 


guideWorks Translator: What is it? 


The guideWorks Translator creates a WinHelp 
project from your Apple Guide source files, 





which you can compile into a WinHelp help 
file using the Windows Help Project Editor, 





Figure 3. The Apple Guide panel created by 
the Guide Script in Listing 1 


THE NEW CLASS OF AUTHORING TOOLS 


The Starter Kit and Guide Composer solve authoring problems 
by using an interface that is almost identical to what the Apple 
Guide user sees. The tools keep track of the panels, topics, 
etc., and display them in the correct sequence and layout. 
Finally, the tools isolate you from the Guide Script by creating 
it for you. 

At any point in entering or editing your help content, you 
can have the tool create the Guide Script, write an 
intermediate text file, and compile it with Guide Maker Lite. 
Guide Maker Lite is included with the tool software, and 
compilation is automatic. The output from Guide Maker Lite is 
a production guide. 
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pple Guide Starter Kit 

The Starter Kit begins with an application that lets you 
select various guide options and preferences. The application 
then creates and launches another application for authoring 
your guide. The derived application becomes the authoring tool 
for your guide. You use it for entering and editing help content. 
The content is embedded in the application like a HyperCard 
stack with an application shell. This produces a very large 
Starter Kit “document” because of all the application overhead. 
This has no effect on the size of the compiled guide. 

You enter topic areas, topics, and index terms in a window 
that looks very much like the Apple Guide access window 
(Figure 4). After entering a topic name, you can enter panel 
content in a panel-like window (Figure 5). Options are 
available for adding coach marks, prompts, and “Huh?” 
sequences. You can reuse existing panels or create new panels. 
The “Full” and “Tag and Body” panel formats are supported. 

A book, Danny Goodman’s Apple Guide Starter Kit, 
accompanies the software and completely documents the tool. 
It also provides a lot of useful information on how to author 
guides and how to modify the Guide Script created by the tool. 


ingle Access Window Builder 


guide Works Translator: 
What is it?[1] 
How do | use it?[2] 
What can it translate?[3] 
| |guideWorks, LLC: 
Products and services[5] 
How to contact them[6] 


ba 

Edit Panels 

4 

4 

ei on ontene on moa coe aon mona teocleameaan 3 


yay capa dtsy een cater ea} STENTS ENTE CLES ETS SeRSeVERSTSNESTE 


‘? Header @® Topic 
(Derete } [Lchange_] 





Figure 4. Starter Kit topic area window 


Panel Editor 


<pict> |The guideWorks Translator creates a Forriat; (Tate) 
WinHelp project from your Apple Guide (J “Huh?” Button 
source files, which youcancompileintoa — 
WinHelp help file using the Windows Help (] Prompt Line 


Project Editor. J custom Panel Prampt 


| 


eB Coach Mark 





Figure 5. Starter Kit panel editing window 
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Guide Composer 

Guide Composer begins with a Topic Areas window 
(Figure 6). You enter topic areas, and topics to go with them. 
A lot of support is provided for indexing and Look-For. Guide 
Composer can automatically generate an index list from your 
content if you wish. This is a great way to start an index list. 
Guide Composer excludes your Ignore words from the index, 
but you may still need to touch up the index list after automatic 
generation. If you prefer, topics can be selectively excluded 
from automatic indexing and have their index terms assigned 
manually. Index terms are entered in a very different way than 
Guide Maker and the Starter Kit. In the other tools, you assign 
a topic to an index term; in Guide Composer, you do the 
reverse — when you create a topic in the Topic Area window, 
you can assign an index term to it. Support for Ignore words, 
invisible index terms, and synonyms is also provided. The only 
thing not covered is the stemmer exception list. 


H) Products and services 


| How to contact therm 


Add Topic Area.. 





Figure 6. Guide Composer topic area window 


Panel content is entered in a panel-like window (Figure 7). 
Options are available for adding coach marks, “Huh?” 
sequences, Apple Scripts, pictures, and sound. Prompts are 
selected at the topic level rather than on a panel-by-panel basis 
as in the Starter Kit. The “Full” and “Tag and Body” panel 
formats are supported. 


> Panel Edit 


fog iit 


guideWorks Translator: What is it? 
The guideWorks Translator creates a WinHelp 


project from your Apple Guide source files, which 
you can compile into a WinHelp help file using the 


Windows Help Project Editor, 





Figure 7. Guide Composer panel editing window 
Guide Composer also lets you modify a “Standard Defines” 


file that is automatically included in the compilation. This is 
handy for modifying many of the defaults and adding your own 
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definitions. Another feature allows you to enter Guide Script 
directly into the panel. This Guide Script is preserved in the 
Guide Composer document and included when the guide is 
compiled. (Guide Script can also be entered directly into the 
Starter Kit panels, but Guide Composer is more explicit about it.) 

The manual describes how to use the tool, but not how to 
design guides. You should also refer to one of the three Apple 
Guide books if you want to develop good guides. 


MAKING CHOICES 

What are the advantages to using the Starter Kit or Guide 
Composer? First of all, you write your help content in the 
context of what the user sees. You can focus on the content 
without getting distracted by scripting and layout. Second, you 
don’t need to learn any Guide Script; the tools create the Guide 
Script for you. Both tools provide a quick start for guide 
development. You can start writing useful guides in a matter of 
days rather than weeks. 

What do you give up by using the Starter Kit or Guide 
Composer? This is a trick question. The answer depends on 
what you want your guide to do. They are best at creating 
simple guides using a single-list access window. A full access 
window is possible, but neither tool provides sufficient support 
for bullet-proof Look-For searching. If you are willing to learn 
Guide Script, the tools provide a fast start for a more complete 
guide. It works like this: Use the tools to produce as complete 
a guide as you can, then switch to the intermediate Guide 
Script file to complete the project. Once you start modifying 
the Guide Script, you can’t go back; any changes made in the 
intermediate file are not retrofitted into the original document. 
Every time you make a change in the original document, the 
intermediate file is re-written from scratch and your changes in 
the intermediate file are lost. 

You will probably want to avoid touching the intermediate 
Guide Script file. Once you do, it requires manually updating 
the intermediate file every time you make a change with the 
tool. Or, you can abandon the original tool and use Guide 
Maker with the intermediate Guide Script file. This approach 
has the advantages of a quick start with the Starter Kit or Guide 
Composer and the completeness of Guide Maker. 


Features Supported 

An important consideration is the Apple Guide features 
supported by the tools. There are many features that the new 
class of tools does not handle. For example, one of Apple 
Guide’s key features, intelligent assistance, requires context- 
sensitive branching. The new tools don’t support this feature. 
Their text editors also don’t support text search-and-replace, a 
major nuisance when you want to make global changes in your 
guide. You'll also need a word processor and Guide Maker if 
you want to use any hot text. Table 1 shows some key Apple 
Guide features for the tools. 
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Apple Guide Feature Guide Starter Guide 
Maker Kit Composer 
ee oT oo a a nacicet. 
Single-list access window YY YY | 
Presentation startup window _ | N N 
en err ee 
Topic Areas YY 
oe ana Geeneeene Sean “aie 
es en ee es 
Sequences == =~=~—__ Alltypes__ Basic linear Basic linear 
ee reer : ae = - 
ee rere ee : a an — 
Styletextinpanels OY) CUNO 
Formas A eee ue ee - 
Coach marks ~~ ~— As 2 available 2 available _ 


“Huh?” sequences ; and panels ALS “uh?” One panel : 
must be topic per “Huh?” 





Drag-and-drop editing = NO yy YY 
Content search- 
and-replace Y (word processor) —N N 
Prompts All _3available 4 available | 
Panel content other than text _— Al None PICT and 
Sound 
Hot text in panel content Y N N 
Buttons. All “Huh?” only “Huh?” 
and Radio 
Source docs file size 1X 1X _1,300K + 1X 


 554-page- _ ~ 295- -page | : 38- -page 
book book —_s manual 


Documentation provided 


Guide compilation | OY YO Y 
Look-For testing Y N N 


Diagnostic support _ Y N 
WinHelp conversion Y N 
Localization, support Y N 


Table 1. Apple Guide features supported by the authoring tools 


Recommendations 

If you want to get the quickest possible start in guide 
development, choose the Starter Kit. It’s well documented and 
produces very useful guides quickly. Watch out for the limited 
Look-For search support. Try it out in your guides and see 
how you like it. You may find that you need to touch up the 
Guide Script to get the results you want. 

If you want a more full-featured guide, use Guide Composer. 
It has good support for indexing and Look-For. It also supports 
more objects and prompts in the panel content. Watch out for 
the limited help menu support. You can only make guides that 
go into the “Help” menu position. To put it into one of the other 
four positions, you'll need to modify the Guide Script. 

If you plan to develop a lot of guides, use Guide Maker. 
It’s still the most complete tool available. It will take you 
longer to learn it and to produce your first guide, but you will 
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VHY NOT USE THE BEST? 


Companies like Adobe, Claris, Symantec, Metrowerks, Netscape and hundreds of others 
recognize the unsurpassed quality of Developer VISE and have switched to MindVision for 
their installation needs. In fact, every day MindVision sells more installers than all other 
competitors combined. Don’t take our word for it. Ask any of our hundreds of satisfied 
customers why they switched from the competition to MindVision’s Developer VISE. 


We didn’t stop there. 
Announcing... 


INSTALLER VISE 4.0 


The New Industry Standard for Software Installers. 





Find, move, rename, or delete any file. Create hierarchical packages. Build one installer for 
multiple languages. Build installers with unparalleled ease. Attach AppleScripts to your 
installation. New archive features allow you to build CD-ROM installers quickly and easily. 

It may not slice and dice, but in addition to installing it also removes. And much, much more. 


And Introducing... 


UPDATER VISE I.! 


The Most Advanced Updater Available. 


Updater VISE is the only product that can update multiple versions of your 68K, PowerPC, 
and Fat application from ONE updater. Updaters are extremely compact and totally secure, 
allowing for easy online distribution. And, combined with Installer VISE you can update any 
number of different files giving you a total software delivery solution. 


Maybe it’s time to stop and take a look at MindVision’s software delivery solutions. 
Visit our web site for full information, 
including fully-functional demos. 


www. mindvision.com 


Email: info@mindvision.com * Voice: (402) 477-3269 © Fax: (402) 477-1395 









MindVision 
Software 





© 1996 MindVision Software. All Rights Reserved. Developer VISE, Installer VISE, and Updater VISE are trademarks of MindVision Software. 











GET YOUR NAME “IN LIGHTS” 


Here at MacTech Magazine, we rely heavily on outside 
writers for most of the material that appears in our pages. 
If readers did not participate in the magazine, sending us 
their ideas and taking the time to write articles, there would 
be no MacTech. We like to think of MacTech as an 
ongoing dialogue amongst members of the Mac 
programming world: we facilitate the discussion, but it’s the 
readers who carry it on, by responding to what they read 
and to their own programming experiences and interests, 
in writing. Sometimes we know that we need something 
specific covered, and we approach someone to write an 
article on that subject; and we do write a few columns in- 
house each month. But it is reader contributions, in the 
form of letters, tips, and especially articles, that give the 
magazine its relevance, its character, and its appeal. 

So MacTech Magazine is not a staff of writers sending 
a constant stream of one-way messages outwards; it’s a 
living, evolving network of readers conversing with one 
another, educating one another, sharing their knowledge, 
their experience, their interest, their trials and tribulations 
and joys and successes in the constantly unfolding story of 
programming the Macintosh. MacTech Magazine doesn’t 
just happen: it’s what the community makes it. If we carry 
reports of future trends and technologies, if we teach 
useful methods, if we review new books and tools, if we 
provoke thought, provide help, ride the wave of current 
interests and concerns, it is only because we reflect the 
thoughts of our readers, who speak through our pages. 

You are invited to involve yourself in this exciting 
conversation amongst readers. You may be working at the 
cutting edge of programming technology, as part of a 
heavily funded professional developer effort; you may be a 


lone hobbyist wrestling to create shareware for the sheer 
love of it. You may have been programming the Mac since 
its inception; you may have just switched over from 
Windows or Unix. You may work in C or C++ or Pascal or 
AppleScript, from scratch or in a framework. You may 
write big apps, small apps, custom solutions, extensions, 
code segments, for profit, for fun, for education, to solve 
one problem once. No matter who you are, no matter 
what your credentials may be, if you have a tale to tell, a 
trick to share, a technique to teach, we want you to 
consider joining the family of those who write for MacTech. 

Don't just wait for a topic to be covered in MacTech! 
Don’t just wish some technique would be explained better! 
Take responsibility! Write us an article yourself! 

To write for MacTech, just send for our Writer’s Kit. It’s 
a Microsoft Word file containing the Styles you need to use, 
and giving lots of helpful advice and information, including 
all the legal stuff. You can let us know what you're writing 
about, if you want suggestions or feedback; this is helpful to 
us, because it lets us plan for the future. Or if you want to, 
you can just write the article and spring it on us when it’s 
done. If we publish your article, you’ll be paid for it! 

Write to me, Matt Neuburg, at managing_ed@mactech.com 
(or one of the other editorial addresses listed on page 2 of 
the magazine). Ask me for a Writer's Kit! Send me an article! 
Get published! Make money! See your name in print up 
there alongside the 
famous denizens of lee 
MacTech! And, most ’ 
important, take the future 
of MacTech Magazine 
into your own hands! 











have much more Apple Guide capability available. You may 
also want to start with one of the new tools and then switch 
over to Guide Maker as you build more confidence. 


Where to get the tools 

Guide Maker accompanies the book Apple Guide 
Complete: Designing and Developing Onscreen Assistance by 
Apple Developer Press. Software updates of Guide Maker and 
Guide Maker Lite are available from the Apple and guideWorks 
Web sites. 

The Starter Kit accompanies the book Danny Goodman’s 
Apple Guide Starter Kit. A demo version of the Starter Kit can 
be downloaded from the guideWorks Web site. (Both books 
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are reviewed in the January article referred to above.) 

Guide Composer is published by StepUp Software (214- 
360-9301). A demo version of Guide Composer can be 
downloaded from the StepUp or guideWorks Web site. 

stepup@onramp.net 

http://rampages.onramp.net/~stepup/ 

The guideWorks Web site has lots of information about | 
Apple Guide and Guide Maker. It also has demo versions of 
the Starter Kit and Guide Composer for downloading. 

http://www.guideworks.com 
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By Michael Hopkins and Noah Liebermann 


This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, is intended 

to give our readers 
technical information on 
using Symantec products. 


Q: When I compile the Animator 
Sample Applet using Symantec 
Caffeine, I get the error, “The last 
command could not be completed 
because the apple event was not 
handled.” Why is this occurring? 


A: You need to be sure that you have 
the Javac.PPC application running 
before you compile. For further 
information, read the Your First 
Applet.pdf Acrobat file. 


Q: When I have compiled my Java 
project, why can’t I choose Run 
from the Project menu? 


A: Symantec Caffeine does not currently 
support building stand-alone 
applications. You can currently build 
only applets, which must be viewed 
as part of an HTML file. You can use 
any Java-enabled browser to view 
them, or use AppletView.PPC, which 
is included in the MacJDK folder. 
Once your applet is compiled, you 
can choose Run-~ Applet 
(examplel.html) from the 
Scripts menu, or use the shortcut 
d6-control-R to run the applet with 
AppletView.PPC. 


Q: The installation instructions for 
Symantec Caffeine say I need 
something called “8.0.4d11” to use 
the Java compiler. What file is this 
referring to? 
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A: This file is the version of the Project Manager required b 


Caffeine. You can find it in the pre-release folder on the 
Symantec C++ release 4 CD. The Project Manager on the 
Release 5 CD is already set up to use Java, so no additiona 
configuration should be necessary. 


: I cannot compile the GraphicsTest demo in the Sample 


Applets folder. How do I get this sample to compile? 


: Files that are mutually dependent and do not include 


package specifications will not compile properly, because 
the environment passes these . java files to the Java 
compiler independently. The work-around is to manuall 
drag all of the files from the Finder onto the Javac compile 
to generate the .class file. See the READ ME! -Known 
Issues... file for information on this and other problems. 


: 1 am compiling a Java project, but I cannot figure out where 


the resulting .class file is being saved. Am I doing 
something wrong? 


: No. When you build a Java project, the . java source files 


are compiled by the Javac compiler and the resulting applet 
is placed in Javac.PPC’s target folder. The default folder is 
classes. With this setting, all resulting .class applet 
files are placed in the JDK Classes folder, which is called 
Caffeine:MacJDK1.0b1l:Classes. Alternatively, you 
can specify the paths for classes and the target by launching 
Javac.PPC and choosing Properties from the File menu. 
Note that the classes path should be the location of the sun 
and java folders containing the JDK library classes. 


: | am trying to use the cursor routines documented in Inside 


Macintosh; Imaging with QuickDraw. 1 have added 
CursorCtl.h, but I still get a link error. Can I use this 
routine with Symantec C++ 8.0? 


: Yes. This routine is supported by our PPC product. To use 


these calls, add PPCToolLibs.o and StdCLib to your 
project. 


: Is there a way to get the frame of a window? I tried looking 


at the portRect, but that is the interior of a window. Can 
I get the rectangle that includes the title bar and any other 
window parts outside of the portRect? 
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Gives you the Information to Program your Best! 
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Information 


Y over 10 years Steve Jasik has brought 
Macintosh Developers the superior debugger. In 
addition to the software, Steve provides timely 

support to his customers. Inspect the feature list and 
see why so many developers use it. In addition to 
basic features such as stepping and breakpoints, the 
Jasik debugger has many advanced features such as 
heap display, a fast memory watch, Soft-MMU, jump 
tracing, ... to help you track down the elusive bugs 
that other debuggers won't help you find. 


In additon, the package includes MacNosy, a global 
interactive disassembler that enables one to recover the 
source code of any Mac application or from the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system environment symbolically! 


“The Debugger” is the debugger of choice at: 
Adobe, Apple, Claris, Kodak, Metrowerks, etc. 
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The Debugger V2 
& MacNosy 


by Steve Jasik. 





Control 


Its Features Include: 


® Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...). 


® Symbolic Debugging of any Macintosh program, ROM, 
Plug-In or code resource (DRVRs, XCMDs, INITs, PDEFs..), 
ASLM & CFM Libraries, OpenDoc parts, GX Drivers, ... 


® Simultaneous Symbolic debugging of multiple “tasks” 
® Object Inspector for MacApp 3 & PowerPlant programs 
® Source level debugging of Symantec C™ projects 


® Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Fast Software Watchpoint to find clobbered variables. 


® Soft MMU (“heap centric” bounds checking) for PowerPC 
programs to find out of bounds references. 


©® Jump Trace to find where a program takes a “wild jump” 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Heap Scramble and Heap 
Check to detect errors before they become disasters 


® Structured display of data (hypertext) with user definable 
structures while debugging 


® Conditional breakpoints to filter redundant information 


® Continuous Animated Step Mode to watch your program 
execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 


PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


® "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 
Runs on all Macs. Call For Group prices or Updates. 


Visa/MC Accepted. 
Available from: Jasik, APDA or ComputerWare (800-326-0092). 


Jasik Designs + 343 Trenton Way, Menlo Park, California 94025 * (415) 322-1386 


URL: http://www.jasik.com 


e-mail: macnosy@jasik.com 
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Yes. There is a struct element called the rgnBBox that can be 
accessed by type-casting the WindowPtr to a WindowPeek. 
The following example demonstrates how to access this data: 
// must point to valid window 


// local copy of handle 
// receives total area of window 


WindowPtr myWindow; 
RgnHandle windowRgnHand1; 
Rect totalWindRect; 


// set up the handle to the structRgn 
windowRgnHandle = 
(Handle) (( (WindowPeek) theWindow) ->structRgn) ; 
// lock the handle since we are ready to access it 
HLock (windowRgnHandle) ; 
// get the rectangle for the entire window 
totalWindRect = (**(RgnHandle)windowRgnHandle) .rgnBBox; 
// unlock the handle, we are done with it 
HUnlock( windowRgnHandle ) ; 


: 1 am using the Think Class Library and Visual Architect to 


create a dialog box. When I run the generated application, 
I notice that the tab order for the CDialogText items is not 
correct. Is there any way to change the tab order without 
re-creating my dialog box? 


: Yes. Tab order is determined by the item numbers of the 


text boxes. For example, if you have three text items 
numbered 2, 7, and 3, pressing Tab in the first edit box 
(number 2) will cause the cursor to jump to the last edit box 
(number 3). To display the item numbers, choose Show 
Item Numbers from the Views menu. You can change 
the tab order of CDialogText items in Visual Architect by 
selecting each item individually and choosing Send To 
Back and Bring To Front from the Pane menu. Bring 
To Front will increase the item number and Send To 
Back decreases the item number. 


: When I click in the go-away (close) box in my VA-generated 


CWindow, I do not receive a cmdClose message like I do 
when I use the Menu option Close or hit #&-W. Why does 
the close box not generate a cmdClose that I can trap, and 
how can I override this mysterious TCL shortcut? 


: The window’s close box circumvents the cmdClose command 


path that is normally issued after the Close menu option is 
chosen. The close box issues a CWindow: :UserClose() 
command, which calls CWindow::Close(), which finally 
calls CDirector::Close(), at which point your close click 
disappears into the forbidding domain of CDirector, having 
completely circumvented the command structure of the TCL. 


Overriding this is fairly straightforward. In the Visual 
Architect, create a new class in the Classes dialog 
window. Call it what you like; TmyWindow would be a 
good choice. Select CWindow from the Base Class 
popup menu, and close the Classes dialogue window. 
From the main VA window, open your window, or create 
one if you do not already have one. Select View Info 
from the View menu. Now select your newly created 
derived class from the Window Class pop-up menu. 
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Once you generate your source code, you need to add 4 
prototype in your header file and then go into the source 
file for your derived class and add the following: 


void TmyWindow: :Close() 


{ 
// Add your own supplementary Close handling routines here 


inherited::Close(); // Call the inherited method 
// to finally close the window 
} 


Now when the close box is clicked, your Close method 
will get called, wherein you can add whateve 
housekeeping functionality you like. 


I am using TCL and the Visual Architect to write my 
application. I have created a modal dialog box with a 
button that sends a cmdQuit. When I run the generated 
application, clicking the button seems to do nothing. In 
fact, I seem to go into some kind of infinite loop and I have 
to force my application to quit. What is going on? 


First of all, it is considered bad form to quit an application 
by clicking a button. That behavior is reserved for the Quit 
item in the File menu. If, for some reason, you really want 
this behavior, you will need to do the following. 


Go into your upper level source for that dialog, and add the 
following class definition: 


class myChore: public CChore 
{ 


public: 
myChore() {} 
virtual void Perform( long *maxSleep ) 
(gApplication->Quit();] 
i 


Now, modify the DoCommand function: 
myDialog::DoCommand( long theCommand ) 
{ 

myChore *theChore = new myChore(); 


switch ( theCommand ) 
({ 
case cmdQuit: 
Close( true ); 
gApplication->AssignIdleChore( theChore ); 
break; 
default: 
x_myDialog::DoCommand( theCommand ); 


By setting up an idle chore, we ensure that the dialog has a 
chance to close before the application quits. 


Special thanks to: Mark Baldwin, Levi Brown, Andrew 


McFarland, and Scott Morison. 
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When it comes to performance dtF is in a 
class all its own. dtF utilizes a proprietary 
query optimization and caching scheme to 
obtain unparalleled performance. If you are 
> in need of a quantum leap in performance, 
use the dtF native PowerPC stand-alone or 
client/server version. 


performance 


Full transaction control and automatic level-3 error 
recovery guarantee maximum data protection even after 
sudden system crashes. dtF databases are compressed and 
encrypted to protect against all unauthorized access, even 
disk editors. Implement sophisticated table and operation 
level security with dtF’s password features. 





...data security 


With dtF’s unique direct integration technology, the dtF database system 
is fully contained in your application, enabling you to build double- 
clickable database applications. Never worry about missing or conflicting 
INITs or drivers. dtF’s native API is compact, easy-to-use and integrates 
seamlessly with all major development environments on the Macintosh. 
dtF’s high performance SQL, integrated data dictionary, security 
features, automatic index selection, query optimization and error 
recovery allow you to concentrate on creating great database applications 
instead of messing around with the internals of the database system. 





"**€8S Of Use 


dtF is available for Macintosh System 7.x (68K and native PowerPC). 
dtF supports MPW C/C++, Symantec C/C++, Metrowerks CodeWarrior 
(all compilers 68K and native PPC). dtF is fully OpenDoc™ compatible. 


Stand-alone Separate versions for use with HyperCard 2.x, SuperCard 2.x, Smalltalk- 
: . : . Agents and Pictorius Peregrine are provided. AppleScript interface via 
applications built with DataScript™ for dtF from General Knowledge. dtF supports cross- 
dtF are royalty-free! platform development on Windows 3.11, Windows 95 and OS/2. 


dtF Americas, Inc. 
19672 Stevens Creek Blvd., Phone: (800) DTF-1790 
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Suite 128 Fax: (510) 828-8755 
Cupertino, CA 95014 AppleLink: DTEAMERICA : 4 | Tall lalallala dalalalalalalalalalalatetaaialaslailaelalaialalaialailaiadalaliaiaialiaded | 
USA Internet: dtRamerica@ 


applelink.apple.com 
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The CodeWarrior IDE 





This month, we’re going to talk to the 
folks responsible for the CodeWarrior 
IDE. By the time you read this, 
Metrowerks will have shipped their 
ninth release of CodeWarrior. In that 
time, the IDE has changed significantly. 
However, there is still a lot of growing 
room left. This interview focuses on 
some of the changes that have already 
taken place, and offers a glimpse into 
the future of the IDE. 


Dave: Where do you see the IDE 
going from here? What kind of 
changes are coming? 


Berardino: The IDE has come a long 
way in the past two years, but we feel 
that a lot remains to be done. The 
main goal for the near future is to 
improve the IDE’s ability to handle 
large projects involving multiple 
developers. Also, with the growth of 
object-oriented languages, we've added 
an object browser to the IDE which 
shipped with CW/8 and will go final 
with CW/9 — but that’s just the first 
release. Many more improvements are 
planned in that area. 


Many complex projects involve the building of multiple final 
binaries, which is usually not easily supported in a project- 
based development environment. We plan to address this 
problem through support for intelligent nested projects, 
along with support for multiple output targets from the same 
project. The build system will also be improved in order to 
better support compiler chaining, where one compiler’s 
output is passed along to another compiler before 
generating a final object file (yacc is a good example of 
this). Source code control will be addressed by adding 
integrated support for our CodeManager system, which is 
the MacOS version of Microsoft’s SourceSafe. 


Dan: We're just finishing the first release of the source code 


browser. It’s really helpful for navigating and editing source 
code, classes in particular. You can browse the full class 
hierarchy, or open a separate browser on an individual 
class. Also, you can see all the types, globals, constants, 
enums, functions, structs and macros in your program, and 
jump instantly to their declarations. 


By the way, the browser is driven by information generated 
by compilers. We've documented the format of this as part 
of our plug-in compiler API, so anyone who makes a drop- 
in compiler can support our browser. 


Dave: How will nested projects work? Can you give us an 


example? 





Berardino Baratta has a Mechanical Engineering degree, which makes him perfectly suited to work as a Mac Developer: he 
can make it up as he goes along. Although vicious rumors abound that he’s actually a manager, he does his best to squash 
these by working on everything from the CFM68K compiler and linker to SIOUX, and he’s lead on the IDE as well. Now if 
only he can figure out how to read email while balancing his 7-month-old son on his knee, then he'll really be able to get 


some work done. 


Dan Podwall wrote the CodeWarrior debugger app and the browser. Before that he worked on application frameworks and 
development environments for a different Mac dev tools company. 


Ey THE CODEWARRIOR IDE 
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Berardino: Nested projects will allow users to encapsulate 
their files into distinct subprojects that are automatically 
tracked and updated, so that when the user issues a make 
from the topmost project, the build system will check to see if 
any of the subprojects need updating and will build those 
first, updating any new dependencies as they are created. 
This becomes more and more important in today’s world of 
component software, where an application is made up of 
many separate plug-ins. The CodeWarrior IDE is a good 





iw» See memory allocation in any open heap at a glance. 
i» Easily spot memory leaks. 
i Flags heap corruption when it happens. 


example of this. Right now we have over 50 projects that are i» Works with source level debugger to let you find memory problems fast. 
used to generate just the Macintosh-specific tools. Currently, wm» Stress applications on the fly with Purge, Compact, and Zap. 

we use AppleScripts to automate this build. With nested im Allocate memory at will for precise stress testing. 

projects, we could have one master project that had as its wm» Log heap data - easily document heap status over time. 

subprojects all the tool projects, which in turn could have w» No need for source code: nothing inserted in code; no patches 
subprojects which generate any libraries that the tools need. to the system. 

With a single make issued at the top level, we would build all iw» Works with 24-bit, 32-bit, and modern memory managers. 

30 or so output files without any further user interaction. For Macintoshes with 68020 or better. Requires System 7.0 or later. 













only $99 US 


Order now hin Adianta, Inc. 
Phone: (415)781-8052 © FAX: (415)781- -8053 
AppleLink:ADIANTA ¢ AOL:Adianta ¢ Internet:adianta @ aol.co 
For VISA, MC, or American Express orders by mail, fax, or Applelink, please include 
name, address, card number, expiration date, and phone number or email address. 
Also available through the MacTech Mail Order Store and APDA 


Dave: Tell me about “multiple target” support. Will I be able 
to choose between 68K, PPC, or fat? Will I be able to 
selectively bind source files to specific targets? 





Berardino: Multiple targets is a feature that many Macintosh 
users have been asking for. Today, building a MacOS — aDeane eg MieomateveDmers 
application involves generating two distinct applications RI BAM C2 NARI NIE eee OMCs eee 
from the same source base, one for 68K users and one for 
PPC users, and then merging them together into a final 
binary. Currently the only way to support this is through 
the use of two distinct projects, or to switch the target from 
68K to PPC, which will strip out the object code you just 
finished compiling. What we plan to do is to have multiple 
targets with persistence, where you can have many different 
targets, such as 68K debugging, 68K release, PPC optimized, 








etc. When you switch to a different target you don’t lose all Features | Help | Sereenetitting | aavasvepc | Think/cw 
your current compiled files. Switching back won't force you Sornnlel= User bennatility 
to recompile all your sources again. We also plan to Multi Pencl Preferences J Custom Default Buttons 
. . . “Ce ‘ F (@) Tabs - Switch panels with tab sheet BX] custom Iter Callbacks 
support binding of files to a specific target, which will allow 7 ae Cae aTEN 
. . : : | OList - Switch panels with custom icons UE SOy aetna 
users to have their 68K libraries ignored by the PPC target EE] Mouse-Sensitive Cursor 


(Popup - Switch panels with a popup Giictaay bindeueead 


and vice versa, or have certain files only compiled for an / | | | “ 
CO Radio Buttons - Switch panels with buttons Password Edit Fields 


x86 target and ignored by MacOS targets, which is useful for Le — | 
user interface-specific source code. This context-sensitive help field was filled | The scroll bars on this text edit field 


when the mouse passed over the Multi Panel become active when the data reaches 
menu. the bottom of the bounding rectangle. 


Meet Charlie. Charlie likes to program. But Charlie hates boring, repetitive code, so 
Berardino: We already support CKID resources in the editor. he created OpenDialog™ OpenDialog is “everything the Dialog Manager should've 


ne been.” Use Charlie’s head for dialogs and save your head (and your hair) for real 
A future release will have the oat state visible from the problems. A set of libraries that replace the Dialog Manager, OpenDialog will 
project window, and will provide all tools which are 


necessary for managing SourceSafe databases. These tools Simplify creation of multi-panel e Easily integrate into existing code. 
will. allow usersto track different versions of their source items, such as preference dialogs. e Cost only $259 (source code license 
code without having to leave the IDE. We will also be Relieve you of silly chores, like available). 


= j managing radio buttons. e Keep you from going bald. (Charlie 
providing a file/folder compare tool in the IDE, which will Provide you with “no-resource” lost his hair before OpenDialog.) 


help users to determine what changed between releases. dialogs for alerts & progress bars. 





FGM Inc. © 703.478.9881 © http://www.fgm.com © email: opndlg42@fgm.com 
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Programmer 
Training 


MACINTOSH SEMINARS & CONSULTING 







Richey Software Training provides 
professional, customized programming Now 

seminars and industry consulting. WindowsNT 
cross-platform 





Rich content & hands-on lab 
exercises shorten your learning curve. 
On-site training is convenient — your 
team eliminates expensive travel costs 
and consuming down-time. 


training 


MAC 
66 Professional training & consultancy SEMINARS 
that really hits the mark. “Cece 
* OOP 
Call today to find out how Richey * PowerPC 


Software Training delivers professional * AppleScript 
: F : . : * Debugging 
seminars and consulting nationwide. 





Training Mac Programmers Since 1986 


707°869 ©2836 
e-mail us at dave@richey.com 
or check us out on the web at www.richey.com 
P.O. BOX 1809, GUERNEVILLE, CA 95446-1809 








y Software Training. All trademarks or registered trademarks are the property 
of their respective owners. Specifications subject to change 




















Dave: Do you plan to support having multiple projects open 
at once? What about supporting threads in the IDE? 


Berardino: Having multiple projects open at once is very 
useful with an IDE that supports subprojects, because it 
allows users to work in two projects at once. Full support 
for threads will allow users to be compiling in one project 
while simultaneously editing a file in another project. With 
the coming of Copland and its preemptive threads, users will 
see less of a performance impact from using threads than 
exists with today’s cooperative threads. We are very excited 
by the performance that Copland can bring to MacOS with 
its microkernel architecture and fully native file system. 
Development tools are typically I/O-bound. A typical 
compile/link cycle can spend 40-60% of its time doing file 
I/O, so any improvements to the file system will translate 
directly into increased compiler/linker speed. Having a fully 
preemptive microkernel will allow us to add features that are 
impossible with the current MacOS architecture. 


Dave: How will the browser change? Will the level of 


integration between the browser and the rest of the 
environment change? 


THE CODEWARRIOR IDE 





Dan: Over time, we’re planning to extend the browser in a 
number of ways. The goals are to simplify the task of 
programming and to create more powerful tools for 
analyzing large, complex programs. 


One important area is to automate some of the routine 
aspects of object-oriented programming. So, you'll be able 
to create new classes and members and be spared the 
hassle of creating new header and source files and filling in 
all the boilerplate code. And the browser will handle 
keeping member function declarations and bodies in sync. 


Many users have asked for a graphical view of the class 
hierarchy, so that’s something we plan to address. Another 
area is to allow browsing of dynamic as well as static 
relationships in programs. We took a browser-oriented 
approach with the user interface of the Metrowerks 
debugger. For example, you can browse through lists of 
local variables, global variables, types and processes. We'll 
extend this by adding support for browsing object instances 
and by supporting object-oriented breakpoints. The latter 
allows you to stop a program when any method of a 
particular object instance is entered, or when any method of 
a particular class is entered. When you are debugging an 
object-oriented program you’re often thinking in terms of 
classes and instances, so the environment should let you 
work that way. 


Dave: What kind of plug-ins will be supported? Why would 


someone want to write their own plug-in? 


Berardino: Almost any type of plug-in can be written, but 


the one major limitation in today’s CodeWarrior make 
system is that we can’t easily support one plug-in’s output 
being fed to another plug-in. The new build system we’re 
planning will allow arbitrary chaining of plug-ins, so users 
can more easily support compilers (such as yacc) which 
generate C source files from their input files, which could 
then be chained to the C/C++ compiler, which would 
generate the final output file. A post-link phase is also 
planned, which would allow users to write custom plug-ins 
that could take the final application and do post-link 
processing on this. Good examples of possible post-linkers 
are: a tool that would merge PEF containers; a tool which 
would create a fat application from two input applications; 
or perhaps a tool that performed optimizations on the final 
generated binary. 
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You Can't Wait Forever. 





Let’s Face It. 


As a professional developer or webmaster, 
you have to think of yourself first. You have 
deadlines to meet, products to deliver, and 
people depending on you. 


A Tool in Hand... 


Your tools are your livelihood. You need up- 
to-date technologies and timely support. You 
can’t afford to wait for vaporware to material- 
ize or for your tools vendor to leisurely add 
features that you need today. 


When Hell Freezes Over? 


When was your text editor last updated? Six 
months? A year? Five years? And when you 
contact the vendor that produced it, do they 
tell you how they’re working on the next great 
version, how wonderful it’s going to be, and 
how it will ship “Real Soon Now”? Or worse 
yet, do you get a disconnected phone number? 


That’s where we come in. 


At Bare Bones Software, we deliver the best 
tools here and now. We have a distinguished 
tradition of continually enhancing the function- 
ality, performance, and design of our products 
to meet our customers’ needs. We don’t allow 
our products to languish until we feel like doing 
something about it. We won’t hype vaporware 
as the solution to today’s problems. And we 
haven't drifted in and out business on a whim. 
We're here to support you for the long haul. 


Bare Bones Software, Inc. 
P.O. Box 1048 
Bedford, MA 01730-1048 USA 


Voice: (508) 651-3561 
Fax: (508) 651-7584 
E-mail: bbsw@netcom.com 


Bare Bones 


Software, Inc. Web: _ http://www.tiac.net/biz/bbsw/ 





What About the Software? 


You don’t have to wait for the software, either. 
We’re constantly refining our techniques and 
technology to bring you the fastest and most 
efficient tools. As the result of our efforts, 
BBEdit has repeatedly raised the standard for 
Macintosh text editing. (In fact, we’ve done so 
many cool things, several of our competitors 
have tried to copy us. Imitation is the sincerest 
form of flattery, after all. We’re very flattered.) 


Why Believe Us? 


Since its commercial debut in 1993, BBEdit has 
set the pace for capability, user-interface, 
functionality, and customer support that others 
have yet to match. BBEdit was the first text 
editor to support ToolServer, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, 
Internet Config, Quickdraw GX printing, 
PowerTalk, PowerPC acceleration, AppleScript, 
Apple Guide, and Macintosh Drag and Drop. 
We're still setting the pace for others to follow, 
as the only Macintosh text editor to integrate 
directly with Metrowerks CodeWarrior, through 
the use of the ClickWarrior extension. 


See for Yourself. 


We’ve painted a great picture, but don’t take 
our word for it. Visit our Web site and see for 
yourself. You'll find lots of things to like. 


BBEdit. Because you 
can’t wait forever. 
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Accelerated for 
Power Macintosh 





MUG 


Choice Product 
FALL 1995 





Our lawyers insist we say: BBEdit and our spiffy logo are trademarks of Bare Bones Software, Inc. Mac and the MacOS logo are trademarks of Apple 
Computer, Inc., used under license. PowerPC is a trademark of International Business Machines Corporation. All other trademarks and registered trademarks 
are properties of their respective holders. Bare Bones Software, Inc. products are cruelty free (except for a few beta testers). © 1996 Bare Bones Software, Inc. 
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By Bob Boonstra, Westford, Massachusetts 


POSTMAN’S SORT 


Everyone knows that sorting algorithms require execution time 
that grows faster than linearly with the number of input records. 
Specifically, sorting N input records is known to require 
somewhere between O(Nlog)N) and O(N2) comparisons, 
depending on the specific algorithm and whether one is 
considering average or worst-case time, right? Wrong. Your 
Challenge is to code a sorting algorithm that requires time 
proportional to the number of input records. 

The bounds in the previous paragraph apply to sorting 
algorithms that are based on pairwise comparison of input keys. 
A distribution sort, however, requires no key comparisons, and 
has different performance characteristics. Imagine, for example, 
how the post office might sort mail. Initially, the mail might be 
distributed into piles by country. Each of those piles might be 
distributed into other piles by state. Those piles might be 
distributed by city, and then by street, and finally by address. 
All of this could be accomplished by making a sequence of 
passes through the input without ever comparing the sort keys 
of two input records to one another. This month, you are to 
implement a distribution (or “postman’s”) sort algorithm. The 
prototype for the code you should write is: 

#include <stdio.h> 

static pascal OSErr PostmansSort ( 
FILE *inFile, /* stream containing sort input */ 
FILE *outFile, /* stream to contain sort output */ 


void *privateStorage, /* preallocated storage for your use */ 
size_t storageSize /* number of bytes of privateStorage */ 


The input will consist of records in the following format: 


[FirstName] <tab> [MiddleName] <tab> LastName <tab> 
StreetAddress <tab> StreetName <tab> 
City <tab> State <tab> [ZipCode] <tab> [Country] <CR> 





Here’s how it works: Each month we present a new 
programming challenge. First, write some code that solves the 
challenge. Second, optimize your code (a lot). Then, submit your solution to 
MacTech magazine. We choose a winner based on code correctness, speed, 
size, and elegance (in that order of importance) as well as the submission 
date. In the event of multiple equally desirable solutions, we’ll choose one 
winner (with honorable mention, but no prize, given to the runner up). The 
prize for each month’s best solution is a $100 credit in the MacTech Mail 
Order Store and a limited-edition, “The Winner! MacTech Programmers 
Challenge” T-shirt (not available in stores anywhere). 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C. Use only pure C code. We disqualify 
entries with any assembly in them (except for challenges specifically stating 
otherwise). You may call any Macintosh Toolbox routine (e.g., it doesn’t matter if 
you use NewPtr instead of malloc). We test entries with compiler options set to 
disable FPU use (for 680x0 code) and to enable all available speed optimizations. 
The compiler to be used and the target instruction set (680x0 or PowerPC) will be 


om i 





Input records should be read from inFile, sorted, and 
written to outFile. Both the input and output files will be 
opened and closed for you by the calling routine. Records will 
consist of up to 8 fields, as indicated above, and be terminated 
by a carriage return (0x0D). Fields will be separated by tabs 
(0x09). The square brackets in the format description are meta- 
characters indicating optional fields; the brackets will not be 
present in the input. Fields may contain embedded spaces or 
special characters (except tabs and returns). 

Records are to be sorted into ascending order with 
Country as the primary sort key, ZipCode (if present) as the 
secondary key, then StreetName, StreetAddress, 
LastName, FirstName, and finally MiddleName, in that 
order. If ZipCode is not present, then State and City 
should replace it as the secondary and tertiary sort keys, 
respectively; otherwise State and City should be ignored. 
Sort order should be lexicographic except when a field value is 
purely numeric, and a purely numeric field should be treated as 
smaller than a field containing non-numeric characters. That is, 
field values “1”, “2”, “10”, “1B”, “1C”, and “2A” would sort in the 
order indicated. Empty optional fields should be considered to 
have the smallest possible value (e.g., records with no 
Country should be output before records with a Country 
value). Your routine should return zero (noErr) if it completes 
normally, or a non-zero error code if it is unable to complete 
the sort for any reason. 

There are no predetermined limits on the number of 
distinct countries, State, City, etc. values that might be 
present in the input. Your routine will be provided with 
storageSize bytes (at least 64KB) of preallocated storage, 
initialized to zero by the calling routine, and pointed to by 


stated in the problem. Limit your code to 60 characters per line; 
this helps with e-mail gateways and page layout. 

We publish the solution and winners for each month’s Programmer’s 
Challenge two months later. All submissions must be received by the 1st day 
of the month printed on the front cover of this issue. 

You can get a head start on the Challenge by reading the Programmer’s 
Challenge mailing list. It will be posted to the list on, or before the 12th of the 
preceding month. To join, send an email to macjordomo@listmail.xplain.com 
with the message “sub challenge-A YourName’. 

Mark solutions “Attn: Programmer’s Challenge Solution” and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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privateStorage. You may not allocate any additional 
memory, although use of small amounts of static memory is 
permitted. If your solution requires additional storage, you 
should create and write to temporary disk files. Adequate disk 
space is guaranteed. In approximately half of the test cases, 
you will be guaranteed at least 32 bytes of memory per record, 
plus 32 bytes for each unique field value. Scoring will weight 
these high-memory cases equally with the cases where less 
memory is provided. 

This will be a native PowerPC Challenge, scored using the 
Metrowerks environment. Solutions may be coded in C, C++, 
or Pascal. If you use a language other than C, you should 
ensure that your code can be called from a test driver written in 
C. Most importantly, to be considered correct, your code must 
sort the input into the proper order without performing any key 
comparisons between input records. The fastest correct 
solution will be the winner. 

This Challenge is based on a suggestion from Peter Shank, 
passed on to me by Mike Scanlin. Peter forwarded a reference 
to an article on the subject by Robert Ramsey, which you can 
find at http:/Awww.silcom.com/~ramey/article.html. 


Two Montus AGO WINNER 
Congratulations to Ernst Munter (Kanata, ON, Canada) for 
submitting the fastest entry to the Mutant Life Challenge. The 
April Challenge was to write code that would propagate a 
population of cellular automata for a specified number of 
generations according to rules generalized from John Conway’s 
Game of Life. 

Of the 17 entries I received, 9 worked completely 
correctly. A number of people submitted solutions that were 
partially, but not completely, correct. Some forgot to stop 
processing and return when the population became stable. 
Others had problems dealing with the BitMap as a torus, which 
required solutions to wrap from the top row to the bottom, 
from the right column to the left, and vice versa. 

Algorithm and data structure selection were key to doing 
well in this Challenge. Several participants recognized the value 
of maintaining, for each cell, a count of the number of occupied 
neighboring cells, and updating the neighboring counts when 
the state of a cell changed. Ernst’s solution takes this idea 
further, and maintains neighbor counts for a block of 32 cells 
together. He uses some interesting modulo-9 math to take 
advantage of the fact that neighbor counts are between 0 and 8 
to store 32 neighbor counts efficiently in 16 bytes. The winning 
solution creates a lookup table, based on the birthRules and 
deathRules provided as parameters, to efficiently determine 
whether a cell birth/death ought to occur. Other details of 
Ernst’s solution strategy are described in his well-commented 
code. It is an interesting and efficient solution that takes 
advantage of the storage provided by the problem statement. 

I used a number of test cases to determine the overall 
score for an entry. The parameters for those test cases are 
listed below. The raw time for each test case was normalized 
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to a common number of propagation generations (1000), and 
then the normalized scores were summed to create the final 
score. The test case parameters are as follows: 





Test Case Birth Death Gener- 
Rules Rules Width Height ations 

1 GliderGun 0x0008 Ox01F3 151 101 1000 

2 Rake 0x0008 Ox01F3 96 100 333 

3 Square 0x0038 Ox0IDF 1100 1100 4000 

4 OKL OxO0AA 0x0155 499 499 — 208 

5 3/4 Life Ox0018 Ox01E7 700 1000 2000 

6 Stop after 80 0x0008  Ox01F3 50 50 80 

7 Huge World 0x0008 Ox01F3 2500 2500 100 

8 Marching Ants 0x0004  0x0017 601 803 1000 


The table below summarizes the results for entries that 
worked correctly or partially correctly. It shows the overall 
score, code size, and data size for each of the solutions, as well 
as the raw score for selected test cases from those listed above. 
Asterisks indicate entries that executed to completion but were 
not completely correct; these entries were disqualified as usual, 
but I’ve listed their times at the bottom of the table of results. 
Numbers in parentheses after a person’s name indicate that 
person’s cumulative point total for all previous Challenges, not 
including this one. 





Name lang score code data Case1 Case3 Case5 Case7 
i a5 oo 
Bill Karsh (80) C132 2804 8 ~©540 «192709 30518 4541 
Randy Boring C = 13530248 «2000 S215): 100431 = 30327-—S ss: 7782 
Andy Antoniewicz C 204 1344 1122 843 415767 62759 = 2285 
John Sweeney (4)  C 362 19884 4554 627 304878 61166-19937 
Ludovic Nicolle(14) C = 479 7200 40 767 277098 84103 32237 
Xan Gregg (92) C 790 2364 8 1205 640475 139368 47749 
Elden Wood  ———C##-—:2036-5152 16-4905. 223790 493359 4349 
Wolfgang Thaller (4) C++ 2225 5088 44 3944 1287532 360201 152793 
*John Nevard (17) C 204 4528 117 289 587092 87061 331 
*Steve Israelson (20) C++ 854 2536 414 1381 614717 156168 53592 
*Moss Prescott C++ 855 2956 1233-1721 905749 = 327008 ~=—:15574 
*Thomas Studer C++ 881 3448 56 996 1231139 146850 33715 
*Jeff Mallett (44) C 930 1808 99032 1491 635424 73610 63609 
*Tom Saxton (10) Gs 1035 2124 131478 836 =1171235 192668 53138 


Special thanks this month to Ludovic Nicolle for investing 


time to create some test code for this problem and for 
distributing it to the Challenge mailing list. Thanks also to 
David Cary for sending me several articles by Michael Abrash 
on optimizing implementations of the Life. And finally, Steve 
Israelson earns 2 points for having been the first to suggest a 
Challenge based on the Game of Life. 

Those of you with an interest in exploring Life further 
might want to start with the page maintained by Paul Callahan 
at http://www.cs.jhu.edu/~callahan/lifepage.html. One of the 
links on that page points to the shareware program LifeLab, by 
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The #1 debugging and development environment for AppleScript ! 





¢ Real step-by-step debugging 











¢ Enhanced trace log 
¢ FaceSpan" link 

















handlers 
beeper 
handler lib 

fl | Sales Update 
Pee 






AppleScript ¥ 


- -Get data fram the text or E-Mail message 
tell application “Scriptable Text Editor” 
activate 
oper alias “INDEX 600:Demo:roger” 
copy word 1 of paragraph 2 of window 1 to client 
set sales to paragery Ses 
set phone to para 
o>] set contact to pa 
end tell 





J histen 
{X] Show Results 








== Build A Statement: WordPerfect 








~-> "Pie" 
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‘Description: the file] Svat 


set dataString to " i 
ito save the object 


set exportPath to 
ee | 
“So9=1232" 









ice --> "Roger's" 


‘Type: a reference to 
existi ng file 
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ONLY 





1 800 616 8320 


Main Event 





Collecti«: 


= copy text returned of the rest 


tell application “Scriptatds 7: 


¢ Vocabulary access ina 


¢ Variable watcher & mouseclick 
expression evaluator: set ¢ Power-assisted statement 
variables, in context, during construction 
debugging! ¢ Multifunction find & replace 


¢ Automatic navigation to 
subroutines 


¢ Background processing 


f you're an AppleScript novice, Scripter will take you by the 
hand and show you the correct syntax for your statements. 
If you know what you're doing, Scripter will help you do tt 


faster than any other editor. Scripter lets you debug properly: 





===; truly line-by-line, so you catch the offending code In the act. 


And only in Scripter can you then fix the problem, and 


“continue debugging — right from where you left off. In fact, 





Scripter has so many exclusive features, we cant list them all 
here. So get a copy today, and start scripting with power! 


ctivate 
open alias “INDEX 600-ferm: 
copy word 1 of paragraph 2s 


“Overall value $000 @ 


set sales to paragraphs 44h: 
-->{"Month Units”, “J 

set phone to paragraph jd of - 

--> "407-555-1232" 


an Scripter 1.0 is top AppleScript editor and debugger... 


If you expect to do anything more than idle fiddling 
with AppleScript, you need Scripter.” — MacWeek, 6/12/95 





+1 202 298 9595 mainevent@his.com AppleLink: MAIN.EVENT 





Andrew Trevorrow, which supports exploration of generalized 
Life worlds and provides a set of initial patterns that lead to 
interesting results. 


Top 20 CONTESTANTS OF ALL TIME 
Here are the top contestants for the Programmer’s Challenges 
to date. The point totals below include points awarded for this 
month’s entries. 


Rank Name Points Rank Name Points 
1. [Name deleted] 176 11. Mallett, Jeff 44 
2. Munter, Ernst 154 12. Kasparian, Raffi 42 
3. Gregg, Xan 92 13. Vineyard, Jeremy 42 
4. Karsh, Bill 90 14. Lengyel, Eric 40 
5. Larsson, Gustav 87 15. Darrah, Dave 41 
6. Stenger, Allen 65 16. Brown, Jorg 30 
7. Cutts, Kevin 57 17. Lewis, Peter 30 
8. Riha, Stepan a1 18. Landry, Larry 29 
9. Goebel, James 49 19. Beith, Gary 24 

10. Nepsund, Ronald 47 20. Elwertowski,Tom 24 


There are three ways to earn points: (1) scoring in the top 
5 of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
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suggest a Challenge that I use. The points you can win are: 


1st place 20 points 5th place 2 points 
2nd place _—:10 points finding bug 2 points 
3rd place 7 points suggesting Challenge 2 points 
4th place 4 points other “good deeds” —2 points 


Here is Ernst Munter’s winning solution: 


MUTANTLIFE.C 


COPYRIGHT © 1996, ERNST MUNTER 
* 
The challenge is to write a fast program that computes the Life-like world some 
generations into the future, Intermediate generations need not necessarily be 
computed, but to me at least, it seems we must process one generation at a time. 


The birth and death rules are specified as bit maps which determine changes as a 
function of any combination of the number of cell neighbors (0 to 8), giving rise to 
2**18 possible rule sets. 


Another requirement is that the propagation function stop as soon as two 
consecutive worlds are identical. 


Additional memory is limited to 1MB plus up to 10 times the size of the original 
bitmap. 
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SYMANTEC C++ 


for Power Macintosh 


Find Out What The Critics Are Saying... 





MacUser 


“Symantec C++ 8.0 for Power Macintosh is an excellent 

development for creating Power Mac applications. Its 

compilers are fast, and its well designed project manager 
interface is a boon for managing large projects” 


Maclech 


“ATL in all the product is incredibly 
good. I think that maybe Symantec has 
made life too easy for me.” 


Macworld 





“Symantec's product is a more 
1995 Byte Magazine polished development 
Readers Choice Award environment and has the 
Best Pr Osramimings Language advantage with its editor, class 
Macintosh browser and compiled code.” 











How do | develop Apple G Guide f les? 


Do This Buy Guide Composer, 


Do this step, then you're done, 





Demo/info:http:rampages.onramp.net/~stepup 


Guide Composer is a trademark of StepUp Software. Apple Guide is a trademark of Apple Computer, Inc. 


Solution Strategy 

We copy the starting bitmap to an internal representation; process this for the 
required number of generations, or until we see no change; and then copy the final 
state back to the original bitmap location. 


The internal cell format includes the state as well as the neighbor count of each cell. 


The propagation process consists of two phases for each generation: phase 1 in 
which all changes are used to update the neighbor counts, and phase 2 in which the 
neighbor counts are re-evaluated, together with the current state, to determine the 
change to the next state. 


Since usually, not all of the cell map changes, it is only necessary to process those 
cells, and their immediate neighbors, that do change. 


Data Structure 


Because of memory limitation, and in the interest of speed blocks of 32 cells are 
stored and processed together. 


A “CellBlock” of 32 cells is a 32-byte structure which contains cell states, cell 
changes, counters, and pointers to allow cell blocks to be chained into linked lists. 


A number of flag bits are stored with each block to allow marking of border blocks 
which require special computation to determine the neighbor cells (wrapping). 


The counts are stored modulo-9 arithmetic, A 13 bit counter holds the neighbor 
counts for 4 cells, and there are 8 such counters located in each cell block. 


CellBlocks are allocated dynamically. 


Computation and Tables 


We must perform 2 kinds of computation: 


Count Updates 

To update the neighbor counts we determine the addresses of the neighbors and 
increment or decrement each modulo-9 counter depending on the change of state to 
0 or 1 


The counter update function is fixed (not dependent on birth or death rules). The 
changes in a row of 10 cells affect exactly 8 counts in the same row and the blocks 
above and below. Hence a lookup table with 1024 entries can be used to provide the 
pre-computed sums of power-9 products with 1 or 0, for two of the 13-bit counters 
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1c 10 Glendora Avenue 
Dallas, Texas 75230 
214-360-9301 


SOFTWARE 214-360-0127 fax 








which are conveniently stored as a pair in a single word. 


State update and its rules 


To determine the state change of a cell we need consider only the state of the cell, 
the neighbor count, and the current set of birth/death rules. 


Given that 4 counts are stored, munged together in a single 13-bit modulo-9 counter, 
we can also use a look-up table for this function. The rules table contains 9*9*9*9 
entries of 1 byte each, where each byte contains a 4-bit birth field, and a 4-bit death 
field, simply derived from the bits in the given birth/deathRules selected according 
to the four neighbor counts implied by the table address. 


This rules table must be computed when PropagateLife is called, to reflect the 
current rules. 


Assuming that PropagateLife might be called frequently in succession, often with the 
same rules, we can avoid re-computing this table unnecessarily. 


And since we can use a “reasonable” amount of static memory (up to 1MB, say), we 
can store a fairly big rule book of many different rules. This would allow alternating 
rules to be handled efficiently as well. 


Hence, all left over available (permitted) memory is used for the rule book. The 18- 
bits of concatenated birth and death rules are hashed into a page index to quickly 
locate a previously computed rules page. 


Other Assumptions 


cells is a bitmap where 
cells.bounds.top=cells.bounds.left==0 
cells.bounds.bottom - cells.bounds.top >= 3 
cells.bounds.right - cells.bounds.left >= 3 


The maximum static memory limit can be #defined, minimum 15K. 


The function allocates dynamic memory equivalent to 8 more bitmaps + 32 bytes. 
It returns 0 if malloc fails. 


“Spontaneous birth” is allowed (birthRules LSB set). 
*/ 


finclude <stdlib.h> 
include <stdio.h> 
include <string.h> 
pascal long PropagateLife( 
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Wow! Oh! 


Why does the new QUED/M 3.0 text editor 


elicit such responses? Because it’s so fun to use, 


interface and access its numerous time-saving 
features, you'll likely have a few happy responses 
of your own to give. 


features you'll appreciate right away: 


@ Macros with a powerful new Programming Dialect 
provide built-in, Basic-like commands 

@ Integrated support for THINK C, CodeWarrior, 
MPW 411 and ToolBox Assistant lets you use 
QUED/M’s advanced editor for all your editing 


Start Having Fun. Order Qued/M 3.0 Today. Get your copy for just $69 at 
http://www.cybout.com/ ¢ info@cybout.com. Or for more information, call 800-281-0101, or 619-481-4366 for Info-by-Fax. htto:/Awww.nisus-soft.com 
©1996 Nisus Software Inc. QUED/M is a trademark, and Nisus is a registered trademark of Nisus Software Inc. All other product names are the property of their respective owners. Nisus main line: 619-481-1477 


BitMap cells, 

long numGenerations, 
short birthRules, 
short deathRules) ; 


// Define amount of static memory to be available, minimum 15K: 
// the value of IMB permits 158 rule pages to be stored 


ftdefine availableStatic 0x100000L 


// You can reduce the size of the program by about 20% by setting 

// LARGE_BITMAPS to 0. 

// But runtime for large worlds (1000x1000) goes up 3-4%. Normally, we would go 
// with the shorter program, but in this challenge, 3% might make a lot of difference: 


define LARGE BITMAPS 1 





~ Type Definitions 


define ulong unsigned long 
define ushort unsigned short 
#define uchar unsigned char 


struct CellBlock { 
ulong state; 
ulong change; 


struct CellBlock* linkl; 
struct CellBlock* link2; 
long count [4] ; 
2 
typedef struct CellBlock CellBlock; 


Struct RulesPage { 
int birthRule; 
THE deathRule; 
uchar rules[81*81]; 
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Yeah! 


that’s why. From the moment you see its inviting 


QUED/M 3.0 makes editing fun by making it easy. Some of the many 








Oo! Right On! 


Recent Reactions lo New QUED/M 3.0 


@ Dynamic coloring of C/C++ keywords and comments color 


codes your work 


@ Unsurpassed editing capabilities, including System 7.5 Drag and 


Drop, noncontiguous selection, unlimited undos, GREP find/ 
replace, Frontier™ and AppleScript support, file comparison, 
text folding, and more! 

Power PC code speeds up editing, searching and macros 


o 
@ HTML macros included for creating Web pages 


FREE Apprentice 4 gives you over 600 MB of working source code 
to include in your own programs. MailKeeper e-mail organizer is 
included too! 

All this and more, for less than you’d pay for 

other text editors! 


si 


Software Inc. 






CYBERIAN 








char pad |[3) 
rs 
typedef struct RulesPage RulesPage; 


struct Bits2Counts { 
long UD; 
long LR; 


} ’ 
typedef struct Bits2Counts Bits2Counts; 





Function Prototypes 
uchar* MakeRuleTable(int b, int d); 


CellBlock* LoadCells(BitMap cells, int width, int padWords, 
CellBlock* cb, CellBlock* L1); 


CellBlock* LoadCellsSpontaneous(BitMap cells,int width, 
int padWords, CellBlock* cb, CellBlock* Ll); 


CellBlock* UpdateCounts(CellBlock* cb, CellBlock* L2, 
int width, int size, int lastColumn, long rightMask) ; 


iif LARGE_BITMAPS 
CellBlock* UpdateCountsNoWrap(CellBlock* cb, CellBlock* L2, 


int width) ; 
ifendif 
ulong ComputeStateChange(CellBlock* cb, uchar* rule); 
void UnloadCells(CellBlock* cb, int size, void* baseAddr) ; 
void UnloadPaddedCells(BitMap cells, int width, 


int padWords, CellBlock* cb); 
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World's Leading FORTRAN 77 for Macintosh 








68K and Power Macintosh versions 
¢ full ANSI 77 native compiler 
¢ faster execution speed 
- graphical source-level debugging 
‘two complete graphics packages 
- make utility, MRWE application framework 
- System 7.5 compatible, MPW included 
- Windows 95/NT version also available 


absetft 


tools and languages 


2781 Bond Street Rochester Hills MI 48309 - (810) 853-0050 « Fax (810) 853-0108 * sales@absoft.com 





Visit us now at http://www.absoft.com 

















Static Data #fdefine IS_U_BORDER(cb) (cb->count[0] & UP) 
#tdefine IS_D_BORDER(cb) (cb->count[0] & DOWN) 
define bcUD(i) ( \ #fdefine IS_L_BORDER(cb) (cb->count[0] & LEFT) 
((((i)>>5)&1)*729L)+((( (i) >>4) &1) *810L)+ \ #tdefine IS_R_BORDER(cb) (cb->count [0] & RIGHT) 
(000) 223) G1) *819L PU (1) 72) 61) *91L)+ \ 
((((i)>>1)&1)*10L)+ ( (4) &1) ) PropagateLife 
#tdefine bcLR(i) ( \ pascal long PropagateLife( 
((((4)>>5)&1) *729L)+(( ( (4) >>4) &1) *81L) + \ BitMap cells, 
((( (i) >>3) &1) *738L)+((( (4) >>2) &1) *82L)+ \ long numGenerations, 
((((4)>>1)&1)*9L)+ ( (i) &1) ) short birthRules, 
short deathRules) { 
#define be(i) { \ 
(beUD{ (4) >24)<<13) PbeUD (1) . (beLR( (i) 294) 4413 )+bcLR(i)) int width=(cells.bounds.rightt31)>>5; 
int lastColumn=(cells.bounds.right-1) & 31; 
define bc4(i) \ long rightMask=OxFFFFFFFF << (31-lastColumn) ; 
be (i), be (itl) ,be(it2) , be (it3) int size=width*cells.bounds.bottom; 
#define bel6(i) \ int padWords=(cells.rowBytes>>2) -width; 
be4(i), be4(it0x4) ,bc4(it0x8) ,bc4(it0xC) long gen; 
#tdefine bc64(i) \ long* allocMem; 
bel16(i) ,bc16(it0x10) ,bc16(it0x20) ,be16 (it0x30) CellBlock* cb; 
define bc256(i) \ CellBlock* L1; 
bce64(i) , bc64(it0x40) ,bc64(it0x80) ,bc64(it0xC0) CellBlock* L2; 
// uchar* rule; 
// Ernst was able to compile these macros on his PC, but CodeWarrior complained 
// they were too complicated. I got it to compile by expanding each BC2560 macro // Get memory for cell blocks, 1 block per 32 cells: 
// invokation into 256 individual bcQ statements. —Bob 
// if (0==(allocMem=(long*)malloc(32+size* sizeof (Cel1Block) ))) 
static Bits2Counts BC[0x400] = { return 0; 


be256(0) ,bce256(0x100) ,bce256(0x200) ,be256(0x300) 
y; // Align cell blocks with cache-line boundary (32-byte): 
define numRulesPages \ { char* temp=(char*)allocMem; 
((availableStatic-sizeof (BC) -16)/sizeof(RulesPage) ) tempt=(32-(ulong)temp) & 31; 
cb=(CellBlock*) temp; 
static RulesPage rulesCache[numRulesPages] ; 








Constants // Clear all cell blocks: 

define MSB 0x80000000L memset (cb,0,size*sizeof(CellBlock)); 
define LSB 0x00000001L 

// Establish the rules look-up table in static memory: 
define UP 0x40000000L 
ftdefine DOWN 0x20000000L rule=MakeRuleTable(birthRules,deathRules) ; 
define LEFT 0x10000000L 
#fdefine RIGHT 0x08000000L // Copy BitMap cells into CellBlock structures and link: 
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// Usually, only non-empty cells are linked, but 
// if birthRules include a “spontaneous birth” bit, 
// all cells must be linked. 


if (birthRules & 1) 

L1=LoadCellsSpontaneous(cells,width, padWords,cb,cb-1); 
else Ll=LoadCells(cells,width, padWords,cb,cb-1l); 
2a? 


for (gen=1;;gent+) { 


// Linked list 1 contains cell blocks with a state change. The state changes are applied 
// to the cell states. Loop 1 traverses list 1 and updates the counts of all affected cells 
// in neighboring blocks and itself. If any counts change, the block is linked into list 
// 2, unless it is already there. 


while (Ll>=cb) { 
if LARGE _BITMAPS 


if ((L1->count[0] & (UP | DOWN | LEFT | RIGHT)) == 0) 
L2=UpdateCountsNoWrap(L1,L2,width) ; 
else 
#endif 


L2=UpdateCounts(L1,L2,width, size, lastColumn, rightMask) ; 
LiL link); 


// List 1 is now empty. Loop 2 finds the cell changes in each block of list 2, using the 
// current states and the neighbor counts. If any state changes, the block is put back 
// into list 1. 


while (L2>=cb) { 

CellBlock* next=L2->link2; 

if (ComputeStateChange(L2,rule)) { 
L2=7ianki=Li 
LI=h2 

} 

L2-)>link2=0; 

L2=next; 


// Xf list 1 is empty (no change) we can make a fast exit: 
if (L1Geb). 1 
if (gen==1) goto quick_exit; //nothing changed! 
break; 
} 
if (gen>=numGenerations) break; 


// Apply last changes to cells in list 1: 
while (Lid=eb) | 
Ll->state “= Ll->change; 
L1=L1->link1; 
} 


// The final states of all cells in the private cell blocks are copied back into the 
// external BitMap storage. A slightly slower function provides for the uncommon 
// case when there are extra unused words beyond the right bound. 


if (padWords==0) UnloadCells(cb,size,cells.baseAddr) ; 
else UnloadPaddedCells(cells,width, padWords,cb) ; 


// Return all allocated dynamic memory to the system: 
quick_exit: 
free(allocMem) ; 


return gen; 





Macros 
// SETBLOCK is used in LoadCells¢..) 
#tdefine SETBLOCK (flag) 
{ ulong c32=*bmtt+; 
cb->count [0]=flag; 
if (¢32) 4 
cb->change=c32; 
cb->link1=L1; 
cb->link2=L1; 
Li-eo 
} 
Cprr; 
} 


BE BEF PPO BO GPE GF GPP GFP GF "Fr 
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SMALLER Packages 

























Why have more than 700 developers selected 
Smaller Installer to deliver their products to cus- 
tomers around the world? 


Y Simple user interface 





Y/Y Customizable windows and splash screens 


Y/Y No scripting required 





Y/Y Compact Pro® compression technology 
minimizes number of diskettes required 


Y Installer uses less than 40K of disk space 


Y Locates and installs files in system-related 
folders (Extensions, Fonts, etc.) 


/ Converts fat binaries to machine-specific 
versions during install 


Y Uninstall capability 


/ Password protection 





/ Extendable operation using your custom code 
resources 


Y Foreign language support — French, German, 
Japanese and Spanish 





Smaller Installer is licensed with a one-time fee. 
No annual fees. Prices vary from $175 to $1,000 
depending on quantity shipped. 





Call or visit our web site to obtain a free developer 
kit which includes everything necessary for creat- 
ing your own installers. 





Smaller 
Installer” 





Cyclos 
P.O. Box 31417 


San Francisco, CA 94131 
415/821-1448 
415/821-1168 (fax) 
sales@cyclos.com 
htto://www.cyclos.com 
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// SETBLOCKs is used in LoadCellsSpontaneous¢..) 
#fdefine SETBLOCKs (flag) 
{ ulong c32=*bmt+; 
cb->count [0]=flag: 
cb->change=c32; 
eb-?>link1=L1; 
eb->link2=L1; 
LI=cb4 
cbtt; 
} 


OO ee ge ge ge ae pe ge 


// LINK is used in UpdateCounts(..) 

#tdefine LINK(cell) 

{ if (((cell)->link2)==0) { 
(cell) ->link2=L2: 
L2-eells 

} 


CO a gg ae ere 


} 


// CHANGE_COUNT is used in UpdateCounts¢..) 

#tdefine CHANGE_COUNT(cell,ctr,delta): 

{ long ent=(cell)->count[ctr] | MSB; 
(cell) ->count [ctr] =cnt+(delta) ; 


ee gga 


} 


// The following three macros are used in UpdateCounts(..) 

i#tdefine UPDATE_COMMON (ctr) 

{ delta=BC [newIndex] .UD-BC[oldIndex] .UD; 
CHANGE COUNT (cUP,ctr,delta); 
CHANGE_COUNT(cDN,ctr,delta); 
delta=BC [newIndex] .LR-BC[oldIndex] .LR; 
CHANGE_COUNT(cb,ctr,delta); 

} 


BO BE ge ge ge pe” 


Needs little disk space : : : : ; es - // C/C++ does not understand negative shifts, so we make separate macros for left and 
Needs little memory sane 
Not just a different look 


// right shifts; 

#define UPDATE _UD(shft,ctr) 

{ int oldIndex=(oldState >> shft) & Ox3FF: 
int newlndex=(newState >> shft) & Ox3FF: 
UPDATE COMMON (ctr) 

} 


am OO 


#fdefine UPDATE_UD_(shft,ctr) 

{ int oldIndex=(oldState << shft) & Ox3FF: 
int newIndex=(newState << shft) & Ox3FF; 
UPDATE_COMMON (ctr) 

} 


Be SF SS 





MakeRuleTable 
uchar* MakeRuleTable(int b,int d) { 


: iste tiace Goiieals iii > // Checks if a valid rules table exists for the current rules, and computes a new table if 
for the Discerning Developer // necessary. 


For all Macintoshes and system versions int pageNumber=((b << 9) + d) % numRulesPages; 
Iti-monitor support RulesPage* rp=rulesCachetpageNumber; 
Full color and multi-m if ((rp->birthRule != b) 


680x0, PowerMac and Fat/Safe format || (rp->deathRule != d)) { 


The finishing touch for a complete 3D look int q,r,s,Q,R,8$; 


De (0 ,tL,t2sts; tay. oso, tr. te: 


V 7 buttons, 9 tabs and 11 sliders (flat/3D text, unsigned char* t=rp->rules; 
flat/3D body, raised/inset title, soft/bold shadows, rp->birthRule = b; 
variable shapes) plus a thermometer ere = Gs 
only 389° V Customizable check boxes plus undefined state t0=( (d) £1) ((b) &0x10) : 
, tl=((d>>1) &1 b>>1) &0x10); 
*Free with V Sliders options: tick marks (1 side/2 sides/none), ee oe - Sean 
Lab el scale (forward/reversed/none), snap or step to t3=((d>>3)&1) ((b>>3)&0x10) ; 
Developer Kit mouse, smart scaling t4=((d>>4)&1) | ((b>>4) &0x10) ; 
t5=((d>>5)&1) | ((b>>5) &0x10) ; 
t6=((d>>6)&1) | ((b>>6) &0x10) ; 
t7=((d>>7)&1) | ((b>>7) &0x10) ; 
t8=((d>>8)&1) | ((b>>8) &0x10) ; 
t[{0]=(uchar)t0; 
t[1]=(uchar)tl; 
t|2]=(uchar) +2: 
t[3]=(uchar)t3; 
t[4]=(uchar)t4; 
t15/=(uchar) t5: 
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=(uchar)t6; 
=(uchar)t7; 
=(uchar)t8; 
561-95 
(s=8;s>=0;s- 


[ 
+= 
for \ 4% 
S=rp->rules([s] <<3; 
for (r=8;r>=0;r—-) 
e 


t 
t 
c 
t 





{ 

R=S | (rp->rules[r]<<2); 

for (q=8;q>=0;q—-) { 
Q=R | (rp->rules[q]<<1); 
t[0]=(uchar) (Q | t0); 
t[1]=(uchar) (Q | tl); 
t[2]=(uchar) (Q | t2); 
t[3]=(uchar) (Q | t3); 
t[4]=(uchar) (Q | t4); 
t[5]=(uchar) (Q | t5); 
t{6]=(uchar) (Q | t6); 
t[7]=(uchar) (Q | t7); 
t[8]=(uchar) (Q | t8); 
c-=9 

} 

} 
} 
} 
return rp->rules; 
} 
LoadCells 
CellBlock* LoadCells( 

BitMap cells, 
int width, 
int padWords, 


CellBlock*® ¢eb, 
CellBlock* Ll) { 


// Copies the states of all cells in the bitmap into the cell blocks, as state changes to 

// trigger evaluation. Sets border flags as needed. Links all non-empty cell blocks in 

// both lists. The special case of “spontaneous birth” is handled by a separate function 
// LoadCellsSpontaneousv..) 


ulong* bm=(ulong*)cells.baseAddr; 
Lit Pa 


if (width>1) { 


//top edge: 
SETBLOCK (UP+LEFT) ; 
for (x=1l:x<width-1;xt+t+) SETBLOCK(UP) ; 
SETBLOCK (UP+RIGHT) ; 
bmt+=padWords; 


//middle rows: 
for (y=l;y<cells.bounds.bottom-l;ytt) { 
SETBLOCK (LEFT) ; 
for (x=1:x<width-1;xtt+) SETBLOCK(0) ; 
SETBLOCK (RIGHT) ; 
bmt=padWords; 
} 


//bottom edge: 
SETBLOCK (DOWN+LEFT) ; 
for (x=1;x<width-1;xt+) SETBLOCK (DOWN) ; 
SETBLOCK (DOWN+RIGHT) ; 
} else { 


//case of bit map <= 32 cells wide 
//top edge: 
SETBLOCK (UP+LEFT+RIGHT) ; 
bmt=padWords; 
//middle rows: 
for (y=l;sy<cells.bounds.bottom-l;ytt) { 
SETBLOCK (LEFT+RIGHT) ; 
bmt=padWords; 
} 


//bottom edge: 
SETBLOCK (DOWN+LEFT+RIGHT) ; 
} 
return Ll; 


} 


JUNE 1996 @ MACTECHMAGAZINE 





UpdateCounts 
CellBlock* UpdateCounts ( 
CellBlock* cb, 
CellBlock* L2, 


int width, 

int size, 

int lastColumn, 
long rightMask) { 


// Processes one cell block: locates its neighbor blocks, and updates their counters 
// according to the state changes of the cells in the center block. 


// The 32 cells of a block are divided into 4 overlapping groups, corresponding to the 
// 4 counter words affected. Only counters whose count changes are accessed, and so 
// flagged (by setting MSB). 


// Notably, right and left neighboring cell blocks are only affected if the first or last 
// bits of the center block change. 


// The function deals with a number of special cases such as wrapping, and the 
// possibly partially filled block at the right margin of the bitmap. 


ulong oldState=cb->state; 
ulong theChange=cb->change; 
ulong newState; 

ulong lastBit; 


CellBlock* cUP=cb-width; 
CellBlock* cDN=cbtwidth; 
long delta; 


if (IS _U_BORDER(cb)) cUPt=size; 
if (IS_D _BORDER(cb)) cDN-=size; 
if (IS_R_BORDER(cb)) { 
theChange &= rightMask; 
lastBit=0x80000000>>lastColumn; 
} else lastBit=LSB; 


newState=oldState * theChange; 
cb->state=newState; 
if (theChange & OxFF800000) { 
UPDATE _UD(23,0); 
if (theChange & MSB) { 
Int etr=3} 
int offset=-1; 
delta=((newState >»30) & 2) - 1; 
if (IS_L_BORDER(cb)) { //wtap 
ctr = lastColumn >> 3; 
offsett=width; 
switch (lastColumn & 7) { 


//carry left 


case O:delta = (delta<<13)*729; break; 
case l:delta = (delta<<13)*81; break; 
case 2:delta = (delta<<13)*9; break; 
case 3:delta = (delta<<13); break; 


i} 

2 

3 

case 4:delta *= 729; break; 
case 5:delta *= 81; break; 
case 6 = 9; break; 


} 


:delta * 


} 
CHANGE_COUNT(cUPtoffset,ctr,delta); 
LINK (cUPtoffset) ; 
CHANGE_COUNT(cbtoffset,ctr,delta); 
LINK (cbtoffset) ; 
CHANGE_COUNT(cDNt+offset,ctr,delta); 
LINK (cDNtoffset) ; 
} 
} 
if (theChange & OxO1FF8000) UPDATE_UD(15,1); 
if (theChange & OxO001FF80) UPDATE_UD( 7,2); 
if (theChange & 0x000001FF) UPDATE_UD_(1,3); 
if (theChange & lastBit) { //carry right 
int ofirset=t14 
if (IS_R_BORDER(cb)) { //wrap 
delta = (((newState >> (31l-lastColumn)) << 1) & 2) -1; 
offset -= width; 
} else delta = (((newState << 1) & 2) - 1); 
delta *= (729L<<13) ; 
CHANGE_COUNT(cUPtoffset,0,delta) ; 
LINK (eUPtofiset) : 
CHANGE_COUNT(cbtoffset,0,delta) ; 
LINK (cbtoffset) ; 


—- 
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BUILD UPDATERS 


WITHOUT PROGRANIMING! 


PaLCHMOIKS P10 


PatchWorks Pro has many options, but only one function: to 
create small, stand-alone Updater Applications which field- 
upgrade your products to newer versions. Updaters can be 
freely and safely distributed online, since they are only of use to 
end-users who've already purchased your software. 


UPDATERS ARE FAST, 
SAFE & EASY FOR END-USERS 
Your end-user just downloads and runs the Updater. The 
Updater prompts the user for the original software via a “Get 
File” dialog box (if not in the same folder as the Updater). 
When the user clicks the “Update” button, the original software 








%B Build Updater 


Why tie-up valuable programming time building updater 
applications? Just fill in a dialog, and PatchWorks does the rest! 
Since there’s no coding or scripting, no bugs are introduced. 


¢ Works with apps, INITs, cdevs, fonts, drivers, etc. 

¢ Works on resource and/or data forks 

° Full support for PowerPC and fat binaries 

¢ Updaters support multiple “old versions” 

* Preserves personalization data (name, serial #, etc.) 

* Customizable end-user interface 

¢ Updaters can execute custom CODE resources 

° Intelligent diff-ing produces small Updaters 

¢ Distribution of Updaters is unrestricted and royalty-free! 


NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 
PatchWorks Pro is used by Macintosh publishers such as: 
Apple Computer, Adobe Systems, MacroMind, Now Software, 
Symantec, WordPerfect, and many more. Pricing begins at $195. 
Download a fully-functional trial version from our web site: 
“http://www.broadcastsoft.com’, or call us at (407) 241-0308. 


BroadCast Software Corp 
East: 407-241-0308, Fax: 407-241-3195 


West: 503-317-0429, Fax: 503-317-0430 
Net: http:/Avww.broadcastsoft.com 
Email: info@broadcastsoft.com 
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UPDATERS ARE CREATED IN MINUTES! 


CHANGE_COUNT (cDNt+offset,0,delta); 
LINK (cDNtoffset) ; 
} 


LINK (cUP) ; 
LINK (cDN) ; 
LINK (cb) ; 
return L2: 


iif LARGE_BITMAPS 

CellBlock* UpdateCountsNoWrap ( 
CellBlock* cb, 
CellBlock*® L2, 
int width) { 


// A stream-lined version of UpdateCounts(..) for interior (non-border) cell blocks 
// which cannot wrap. 


ulong oldState=cb->state; 
ulong theChange=cb->change; 
ulong newstate; 


CellBlock* cUP=cb-width; 
CellBlock* cDN=cbtwidth:;: 
long delta; 


newstate=oldState “ theChange; 
cb->state=newState; 
if (theChange & OxFF800000) { 
UPDATE UD(23,0); 
if (theChange & MSB) { //carry left 
I Oe ae 
int offset=-1; 
delta=((newState >>30) & 2) - 1; 
CHANGE_COUNT (cUPtoffset,ctr,delta); 
LINK (cUPtoffset) ; 
CHANGE_COUNT(cbtoffset,ctr,delta); 
LINK(cbtoffset) ; 
CHANGE_COUNT(cDNtoffset,ctr,delta); 
LINK(cDNtoffset) ; 
} 
} 
if (theChange & 0x01FF8000) UPDATE_UD(15,1); 
if (theChange & 0x0001FF80) UPDATE_UD( 7,2); 
if (theChange & 0x000001FF) UPDATE_UD_(1,3); 
if (theChange & LSB) { //carry right 
int offset=t1; 
delta = (((newState << 1) & 2) - 1) * (729L<<13); 
CHANGE_COUNT (cUPtoffset,0,delta) ; 
LINK (cUPt+offset) ; 
CHANGE_COUNT(cbtoffset,0,delta) ; 
LINK(cbtoffset) ; 
CHANGE_COUNT(cDNtoffset,0,delta) ; 
LINK(cDNtoffset) ; 
} 


LINK (cUP) ; 
LINK(cDN) ; 
LINK (cb) ; 
return L2: 


} 
fendif 





ComputeStateChange 
ulong ComputeStateChange(CellBlock* cb,uchar* rule) { 
// Computes the state change for 32 cells in a cell block. 


// The 4 counters are flagged, and only those counters that actually changed need to 
// be considered. 


// The algorithm computes 32-bit birth and death masks from the counts: Each counter 
// word cb->count[i] contains two 13-bit counter values. These are used successively 
// to index into the rules table each time extracting two 4-bit fields, for births and 

// deaths according to the 4 modulo-9 counts inherent in the counters. The 4-bit fields 
// from all lookups (or 0) are separately stacked into 32-bit birth and death masks. 
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/ Note: counters that are known not to have changed 
/  (MSB clear) cannot effect a state change and are 
/ skipped in the evaluation of counts. 


/ In each bit position then, each state bit selects the corresponding birth or death 
/ mask as follows: A 0-state selects the birth bit, and a 1-state selects the death bit. 


oldState birth death change 
0 0 X 0 


0 1 y 4 1 

] x 0 0 

: x 1 1 
/ 


/ This is conveniently expressed as (in Pascal): 
/ change := (old AND death) OR (NOT old AND birth) 


/ And we can perform this function on all 32 bits at once. 


/ PowerPC has an instruction (rlwinm) that can & and >> 
/ immediate, all in one clock cycle. 
// Let’s hope the compiler knows how to use it here. 


ulong stateChange; 
ulong db4_hi,db4_1lo,d32=0,b32=0; 
long cnt; 


if ((ent=cb->count[0])<0) { 
cb->count[0] = cnt & (~MSB); 
db4 hi = rule[(cnt>>13) & Ox1FFF] ;//mask off flag bits 
= rule[ cnt & OxlFFF]; 
((db4_hi & Ox0F) << ol a. & OxOF) << 24); 
( ( 





(db4_hi & OxFO) << 24)|((db4_lo & OxFO) << 20); 
} 
if ((ent=cb->count[1])<0) { 
cnt &= (~MSB); 
cb->count[1] = cnt; 
hi = rule[cnt >> 13]; 


db4 hi. = 

db4_lo = rule[cnt & OxlFFF]; 

d32 |= ((db4_hi & Ox0F) << 20) ((db4_lo & OxOF) << 16); 
b32 |= ((db4_hi & OxFO) << 16)|((db4_lo & OxFO) << 12); 


} 

if ((ent=cb->count[2])<0) { 
cnt &= (~MSB); 
cb->count[2] = cnt; 

rulelent >> 13); 


db4_hi = 

db4_lo = rule[cnt & Oxl1FFF]; 

d32 |= ((db4_hi & OxOF) << 12)|((db4_lo & Ox0F) << 8); 
b32 |= ((db4_hi & OxFO) << 8) ((db4_lo & OxFO) << 4); 


} 
if ((ent=cb->count[3])<0) { 

cnt &= (~MSB); 

cb->count[3] = cnt; 

db4_hi = rule[cnt >> 13]; 

db4_lo = rule[cnt & Oxl1FFF]; 

d32 ((db4_hi & Ox0F) << 4)| (db4_lo & Ox0F); 

b32 (db4_hi & OxFO) ((db4_lo & OxFO) >> 4); 
} 


stateChange = (cb->state & d32) 
(~(cb->state) & b32); 

cb->change=stateChange; 

return stateChange; 





UnloadCells 
void UnloadCells(CellBlock* cb,int size,void* baseAddr) { 


// Simple sequential copy of all cell states from 
// cell blocks to bit map, loop unrolled once. 


ulong* bm=(ulong*) baseAddr; 
while (size>1) { 
e1ze-=7* 
bm[0]=cb[0].state; 
bm[1]=cb[1].state; 
bar=2' 
epr=24 
} 
if (size) *bm=cb->state:; 
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SOLID SOLUTION FOR 
ELECTRONIC DISTRIBUTION 


Broadcast 


BroadCast is a highly secure, patent-pending system for safely 
distributing “locked” software online, or on CD-ROM. This 
cutting-edge technology was developed by the same 
engineering team behind PatchWorks— our tool for creating 
online updaters that’s become an industry standard used by 
clients like Apple Computer, Adobe Systems, MacroMind, Now 
= sae Software, 
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1234 Any Street 
Suite 123 


(123) 456-7890 x1234 


1234 5678 9012 $456 


BROADCAST IS EASY 
FOR YOU AND YOUR CUSTONIERS 
In seconds, BroadCast securely locks your product into an 
Unlocker application that can be safely distributed to the 
public. To buy your product, customers simply run the 
Unlocker— then either call you, or complete an onscreen order 
form that’s emailed or faxed to you with a unique “control 
number” (and encrypted credit card data). 


Your staff processes the credit card, registers your new user, 
and provides your customer with a password based upon the 
control number. To unlock your software, the customer enters 
this password in the Unlocker. 


BROADCAST IS INEXPENSIVE 
We aren’t resellers or distributors. Customers buy directly from 
you, and we take no percentage of your sales— just a small fee 
per transaction. In fact, BroadCast is distributed for free. We're 
betting you'll quickly use the free password points that come 
with BroadCast, and purchase more as your sales soar. 


We'll even help attract customers by advertising your products 
for free on our “Software Unboxed” internet mall. 


GET THE WHOLE STORY 
We invite you to learn more by visiting our internet web site at 
“http://www.broadcastsoft.com”, and download your free 
BroadCast Starter Kit, or email us: “info@broadcastsoft.com”. 


BroadCast Software Corp 
East: 407-241-0308, Fax: 407-241-3195 


West: 503-317-0429, Fax: 503-317-0430 
Net: _ http:/Avww.broadcastsoft.com 
Email: info@broadcastsoft.com 
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The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP™ and 
Open Transport™, here’s your solution! 












¢ Supports Script Editor, FaceSpan™, and HyperCard™ | 

¢ Build net-wise WebSTAR™ CGI scripts >, 
and NetScape™ CCI scripts oo 

¢ Sample scripts include FTP, Gopher, 
Telnet, Post Office, E-Mail and more 

¢ Featured on the Apple® Internet Server 


Order now through the MacTech Mail Order Store at 
805-494-9797 or other mail order stores 
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617-327-8663 * http://www.mangotree.com 
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| Copyright © 1996 Mango Tree Software, Inc. 
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// 

// The following 2 functions will handle the loading and unloading of cell blocks for 
// the less likely scenarioes. Keeping these complications out of the mainstream 

// functions above is really only a tweak to not waste time on frequent checks, 

// noticeable only with very short runs. 








LoadCellsSpontaneou: 
CellBlock* LoadCellsSpontaneous ( 
BitMap cells, 
int width, 
int padWords, 
CellBlock* cb, 
CellBlock* L1) { 


// Same as LoadCells(..) above, but handles the special case 
// of “spontaneous birth” by linking all cells. 


ulong* bm=(ulong*)cells.baseAddr; 
int X,Y; 


if (width>1) { 


//top edge: 
SETBLOCKs (UP+LEFT) ; 
for (x=1;x<width-1l;xt+) SETBLOCKs (UP): 
SETBLOCKs (UP+RIGHT) : 
bmt=padWords; 


//middle rows: 
for (y=l;y<cells.bounds.bottom-l;yt+) { 
SETBLOCKs (LEFT) ; 
for (x=1;x<width-1l;x++) SETBLOCKs (0); 
SETBLOCKs (RIGHT) ; 
bm+=padWords; 
} 


//bottom edge: 
SETBLOCKs (DOWN+LEFT) ; 
for (x=l;x<width-1;xt+) SETBLOCKs (DOWN) ; 
SETBLOCKs (DOWN+RIGHT) : 
} else { 


//case of bit map <= 32 cells wide 
//top edge: 
SETBLOCKs (UP+LEFT+RIGHT) ; 
bmt=padWords; 
//middle rows: 
for (y=l;y<cells.bounds.bottom-1l;y++) { 
SETBLOCKs (LEFT+RIGHT) ; 
bmt=padWords; 
} 


//bottom edge: 
SETBLOCKs (DOWN+LEFT+RIGHT) ; 
} 
return L1; 





UnloadPaddedCells 
void UnloadPaddedCells( 
BitMap cells, 
int width, 
int padWords, 
CellBlock* cb) { 


// Copy all cell states from cell blocks to bit map, 
// tow by row, skipping unused pad words at the end of 
// each row in the bit map. 


int: 3 
ulong* bm=(ulong*) (cells.baseAddr) ; 
for (y=0;y<cells.bounds.bottom;y+t) { 
for (x=0:x<width:x++) | 
*burt=cb-7state: 
Corrs 
} 
bmt=padWords; 
} 
} 
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By Drew Sarkisian and Faroog Butt 


SPM, Be My Host! 


Considerations on 
plugging a compiler 

into the Symantec Project 
Manager 


INTRODUCTION 


The majority of developers for Mac 
OS-compatibles employ some form of 
Integrated Development Environment 
(IDE) for application development. The 
two most popular IDEs available for the 
Mac OS are Symantec’s Symantec Project 
Manager (SPM) and Metrowerks’ 
CodeWarrior environments. These IDEs 
provide intuitive interfaces, simplified 
project management, extremely quick 
compilers and linkers, GUI development 
frameworks and integrated debugging 
facilities for fast application development. 

Motorola has offered highly 
optimizing C, Ct+t+ and FORTRAN 
compilers for the Mac OS since May 
1995. These compilers are hosted in the 
Macintosh Programmer’s Workshop 
(MPW) environment, a UNIX-like 
command line-driven shell. Our 
compilers have had a mixed reception: 








PeywerPc 








Mac OS developers are very enthusiastic about the quality of 
the code generated, yet most developers would rather work 
under either the SPM or CodeWarrior environments. We have 
received numerous requests to rehost our compilers to SPM and 
CodeWarrior. 
This article discusses the story of our first IDE port, to SPM. 
We will try to give the reader a flavor of our experiences: the 
quick victories, the challenges, and last but not least, the 
problems. We hope this article will give tools developers a 
better understanding of the issues involved in creating a 
compiler plug-in of this kind. Please note the following: 
e This article covers only our C compiler (mec). The port of 
our C++ is in progress. 
e The SPM-hosted compiler is hosted only on PowerPC. We 
don’t have any information or advice for folks who would 
like to create 68k (or FAT) tools to run under SPM. 


BACKGROUND OF MCC 

mec is an ANSI-compliant C compiler that generates highly 
optimized code for the PowerPC architecture. The compiler was 
initially designed to run on an AIX PowerPC host and generate 
code for an AIX PowerPC target (IBM XCOFF object file format). 
mecc has been successfully ported to the Parsytec PARIX 
PowerPC platform (host/target), SunOS/Solaris SPARC platforms 
(as an AIX-targeted cross compiler), Windows NT for PowerPC 
(host and target), and even MS-DOS (running as an extended- 
DOS application). The second Developer’s Release (DR2) of our 
MPW-hosted compilers was released in December of 1995. 

These compilers (we claim) currently generate the most 
efficient code of any Mac OS—hosted PowerPC compilers 
available to date. The major benefit gained from using the 
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Motorola compilers is the speed of the final executable. The 
technology comes from a UNIX background, where compilers 
are generally judged on the efficiency of the code they 
generate. The Macintosh platform has for a decade been a 
model of ease-of-use, user-oriented computing; this is reflected 
by the speed and elegance of the SPM environment. By 
porting mec into SPM, we've opened the door for SPM 
developers to take advantage of our compiler technology while 
retaining the use of their favorite IDE. 

There are drawbacks to using mee: the compiler’s memory 
requirements are much larger than those of the native SPM 
compiler, and the speed of mec itself is much slower. mec 
was never designed to be a “quick” compiler; its claim to fame 
is the quality of the generated PowerPC code. The relatively 
slow compile speed, though, shouldn’t be a deterrent from 
using mec under SPM. The scenario we envision typical 
developers following goes something like this. The native SPM 
compiler (Symantec C/C++) would be used for day-to-day 
development (fast compile/debug cycles), while mec would be 
used to rebuild the product at reasonable intervals, (1) to 
ensure C source compatibility, (2) to make certain that such 
coding errors weren't introduced as might trip up an optimizing 
compiler, and (3) to see just how fast the application runs. 

Symantec, for its part, has provided an open interface to the 
SPM (which is what this article is really about). Symantec 
recently announced the availability of Apple’s MrC/C++ 
compilers as SPM drop-ins. The work was done by Symantec 
engineers, which may erroneously lead some developers to 
believe that only Symantec can rehost translators as SPM drop- 
ins. As we show in this article, this is certainly not the case! 
Nearly all of the work that was done hosting mec as an SPM 
drop-in was done at Motorola in Austin, TX. Given that their 
drop-in interface was fairly new, Symantec proved very 
supportive and provided technical help to speed up the process. 
The majority of our drop-in was created without Symantec’s 
direct involvement. Taking advantage of many of the features 
of the SPM environment does not have to be an “inside job.” As 
Symantec refines their drop-in architecture, we expect future 
drop-in ports will not require any aid from Symantec. 

[Such refinement is constantly under way, and anyone 
working on a translator should contact support@devtools. 
symantec.com to be certain of using the latest specs. The v8r5 
release, though, has virtually no changes to the spec, we are 
told. In other words, the message from Symantec is, don’t allow 
concerns about the continuing evolution of the architecture to 
prevent you proceeding. — man | 


THE IMPORTANT ISSUES 
In the most generic sense, compilers that are driven from the 
command-line have fundamental differences from those driven 
from (Macintosh) IDEs. Here we'll bring up some obvious (and 
maybe some not so obvious) points of difference. 
Command-line compilers take their options and arguments 
from a command line typed by a user or generated by a 
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Makefile. On the other hand, compilers hosted within IDEs 
have visual interfaces via dialog boxes, preference panels, etc. 
Of course adding these user interfaces to a product isn’t rocket 
science (unless you’ve never written any GUI code on a Mac — 
then, it can be like getting cold fusion up and running!). 

A much more serious difference concerns the allocation 
and freeing of system resources. Many compilers from UNIX 
(or even Mac’s MPW environment) don’t do a good job of 
cleaning up all of the heap memory they may allocate, since 
the system (or MPW shell) will reclaim that space automatically 
when the compiler process terminates. Keeping this memory 
allocated when running under an IDE would create a memory 
leak, eventually crashing your IDE or the Mac itself. A similar 
situation arises concerning leaving open file descriptors lying 
around. Simply stated: command line-based compilation 
systems often assume that each executable component will be 
launched by a shell and that when its particular job is done, it 
will be cleaned up after. 

A related assumption made by command-line compilers 
concerns the initialization of static data. Upon each 
invocation of a command-line compiler, the system loader will 
initialize all of the compiler’s static variables to either 0 or pre- 
set values determined at compile time. A compiler hosted 
under an IDE may need to remain resident, and might have to — 
explicitly re-initialize its own static data between compiles. 

Compilers from non-Macintosh environments often use 
ANSI C file /O functions (fopen(), fread (), etc.) to process 
source files for compilation, producing temporary files, and 
generating resultant object files. Such compilers deal 
exclusively with ANSI file I/O abstractions such as pointers to 
files, etc. This may sound alien to folks used to Macintosh 
Handles or FSSpecs, but it’s a fact of life in the world outside 
Mac OS. While file I/O is essentially file I/O, discovering that a 
stat() call under ANSI file I/O translates to a 
FSMakeFSSpec(), followed by a ResolveAliasFile(), 
followed by a PBGetCatInfo() is not obvious to tools 
developers porting their software to the Mac OS. 

IDEs have their own ideas on how to locate source files and 
headers files. The most recent copy of a file could be open in an 
IDE editor window. When the user asks for that file to be 
compiled, an IDE-hosted compiler has to know that the file in 
question is in memory, and not on disk, and access it accordingly. 

When a programmer presents some syntactically incorrect 
program to a command-line compiler, the compiler presents the 
error messages directly to the terminal (console, window) that 
processes the command-line. This is not very useful when 
running under an IDE since there is no “console”; the compiler, 
therefore, needs a mechanism for communicating errors to the 
IDE in such a way that the IDE can present the errors using its 
errors/warnings window. 

Something often overlooked when porting software over 
from UNIX to the Macintosh is the fact that the Mac OS is a 
cooperative multitasking environment. This means that you 
must find a way to share processing time between your drop-in 
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and the IDE it is running in. If you don’t, the users will have 
no way of interrupting a long build, or performing other tasks 
while a compile is taking place. This facet of the Mac OS is an 
interesting challenge when initially porting a compiler. 


SYMANTEC PROJECT MANAGER 8.0 
SPM (version 8.0 and higher) is an open environment; with 
some amount of effort, developers can port their own 
development tools to run under the SPM. These ported tools 
are called “drop-ins”; with the 8.0.4 release of SPM, Symantec 
provides all of their compilation tools as drop-ins. 

Languages currently supported by SPM include C, C++ and 
Pascal: the IDE provides a syntax-highlighting editor for these 
languages. Work is in progress to support FORTRAN in the 
near future. 

Supported object file formats is a sticky question. The 
standard object file format for PowerPC is XCOFF, inherited 
from IBM’s AIX. While SPM projects can process XCOFF library 
files, the internal object file format of the project is a 
proprietary invention of Symantec. Current development 
efforts favor drop-ins that generate XCOFF object files, rather 
than arbitrary object file formats. 

SPM offers a choice of two linkers: the SPM (internal) 
incremental linker, or MPW’s PPCLink Ginvoked from within 
SPM via ToolServer). The incremental linker is very fast, and 
allows for debugging of SPM-built applications, but it normally 
supports only Symantec’s internal object file format (this 
restriction is currently being addressed — more on this later). 
The PPCLink interface allows drop-ins that generate XCOFF 
object files to be used along with the SPM, but sacrifices the 
ability to use the Symantec debugger on resulting applications. 


Compiler Toolkit 2.1 

Symantec provides a “Compiler Toolkit” with the latest 
versions of SPM. This toolkit is designed to give the aspiring 
tool developer the basic information needed to convert his/her 
compiler or translator into an SPM drop-in. It includes 
documentation (some of it rather out-of-date), an example 
project, and pre-built libraries (some with source!) needed for 
creating a drop-in translator of your own. 

The first place to start is looking over the included 
documentation (in Adobe Acrobat format) found in the 
Compiler Toolkit 2.1:documentation folder: 

e Compiler Writer's toolkit.pdf 
e SPM Compiler Writers guide.pdf 
e SPM Debug format.pdf 

e SPM Options.pdf 

Compiler Writer's toolkit.pdf is the most 
immediately useful document. It is an overview of the entire 
Compiler Toolkit, and includes a detailed walk-through for 
porting the empty ~ranslator example (source code and 
projects provided, of cu'rse). This document also contains 
information on whom to -ontact at Symantec for more 
information and/or assistance. The remainder of this article 
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will refer to this document. The next two documents were not 
used during our initial project port; they contain some 
interesting information, but are not currently up-to-date. 
Finally, SPM Options.pdf covers how to set up options 
dialog boxes for your translator to run under SPM. 

While Symantec recommends that you build your drop-in 
under SPM, they went to the trouble of providing all the 
interfaces and libraries necessary for building your drop-in 
under MPW as well. We appreciated this very much, since we 
built the current MPW-hosted mec compiler with mec under 
MPW. Having the ability to re-use our MPW makefiles for the 
SPM re-host project greatly increased our productivity, since we 
didn’t need to invest any time re-inventing (and debugging) 
build procedures. The MPW-specific portions are in 
Compiler Toolkit 2.1: (MPW). 

There are numerous project files in the Compiler 
Toolkit 2.1 directory that all refer to the example “empty” 
translator drop-in. The two most immediately useful to us were: 
ePPCempty.t Symantec Project Manager project 
for a PowerPC host. 


MPW makefile for the empty 
translator. 


eempty.make 


The example proved to be quite helpful. It gives a 
simplified overview of the minimal requests that a drop-in needs 
to support in order to work correctly in the SPM environment. 

The most pleasant surprise in the entire package was the 
SPM drop-in support library. The entire package has been well 
organized and provides excellent abstractions to ease the task 
of interfacing your drop-in with SPM. The folder Compiler 
Toolkit 2.1:SPM_Libraries contains the following files 
and folders of interest: 
ePPCSPMLib.o (PowerPC) SPM callback interfaces. 
e PPCSPMThinkxcoff.o (PowerPC) XCOFF object file 

manipulation routines. 
eSPMShell.r Resource file for building a drop-in 
with a minimal options interface. 


e:thinkxcoff: Thinkxcoff library sources . 


e:spmlib: SPMLib sources. 

Having the source files available for the SPM support 
routines was especially convenient. Not only did we learn a 
great deal about how these interfaces were actually supported, 
we also managed to fix a minor bug in the library routine 
__SPM_error(). 

Finally, the folder Sym Ctt+ for Power 
Macintosh:Standard Libraries:PPC Shared 
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Libraries: contains the PPCANSI and PPCUnix shared 
libraries. The first is necessary, while the second provides 
some simple support for UNIX-style functions such as 
getpid(), etc. 


Restrictions on Drop-in Tools 

It’s difficult to make a complex environment such as SPM 
be both open and efficient; yet Symantec has managed to do a 
good job at both. Still, you can’t have everything; there are 
certain limitations and restrictions you'll have to deal with to 
host your compiler under SPM. 


e Never call the ANSI exit(), assert() or abort() 
routines from your drop-in! This is a quick way to blow 
away the SPM IDE itself, rather than merely terminating the 
execution of your drop-in. 


¢ Do not allow any use of the ANSI console I/O. Although 
console calls such as printf() and scanf() are 
supported by the Symantec-provided PPCANST library, using 
ANSI console I/O (i.e. any routines that use stdin, stdout 
or stderr) wreaks havoc with SPM’s window management. 


¢ SPM does not currently support multi-process drop-ins. 
This pertains to some compilers that consist of two or more 
separate executables that are called in sequence to perform 
different stages of the compilation process. 


e You must use Symantec’s PPCANSI libraries. Why? Because 
the library of callbacks into the SPM (SPM1ib) relies on it. 
While this is not a major problem on the surface, it does give 
you a chance to make an interesting and frustrating mistake. 
If the compiler you are using to compile your compiler (yes, 
we did say that!) translates "\n" to "\r" (and vice-versa), 
your final application will not function correctly with the 
PPCANSI library routines. For Symantec compiler users, 
you must use the -nomapcr option to suppress this 
translation when compiling your drop-in. 


COMMUNICATIONS BETWEEN SPM AND Drop-Ins 
At this point, we'll be covering the initial interfaces between 
drop-ins and SPM. This part isn’t difficult to conceptualize, but 
it’s nice having it spelled out in obvious terms. 
SPM expects to be able to give the following requests to 
any drop-in compiler: 


reqInitialize Drop-in is to perform any 
needed initialization. 

reqCleanup Drop-in is to clean up any 
resources it may still have 
allocated. 

reqCompile Full compile. 
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Other requests that you may wish to support include: 





reqCompileDebug Full compile and produce 
debugging information. 

reqCheckSyntax Check source for syntax errors 
only. 

reqPreprocess Run the C preprocessor and 
return the preprocessed result. 

reqPrecompile Produce a precompiled header 
file. 

reqDisassemble Produce an assembly listing 


(only) of the file. 

These requests are defined in Compiler Toolkit 

2.1: (MPW) : Interfaces: SPMIncludes folder. How does 

SPM communicate these requests over to the drop-in? Your 

drop-in must have a main() entrypoint which accepts the 
following arguments: 


main (long int placeholder, struct Intf *pintfLocal) 


The first argument’s name speaks for itself. The second 
argument is a pointer to the SPM options block. This data 
structure contains all the information concerning the particular 
action that SPM is requesting. This includes the specific 
request, the name of the file to be compiled, a pointer to the 
options to be used for this particular compile, etc. 

One of the easier modifications to make is to create a new 
main() entrypoint for a drop-in and to simply rename the 
original main() entry orig_main() (or something a little 
more creative). With a little preparation, you can call 
orig _main() from main(), cleanly separating the SPM- 
specific processing from the common (and generic) processing 
your compiler originally performed. An example at this point 
seems appropriate: 





Listing 1: Example drop-in mainQ entrypoint for a prospective drop-in 


int main (long placeholder, struct Intf *pintf) 
{ 
int argc; // Arg. count 
char **argv; // Arg. vector: pointer to array of strings 
char args[512]; // Local copy of arguments 
struct Options *poptions; // Pointer to cmd-line 
int success; 


// Make a global copy of pintf for use throughout our drop-in. A matter of taste. 
global_pintf = pintf; 


// Allow SPM to initialize the data in the Intf structure. 
__SPM_init (global_pintf, 0); 


// Handle the particular request from the SPM. 
switch (global_pintf->request) { 
case reqInitialize: 
case reqCleanup: 
success = 1; //SPM wants 1 for success! 
break; 
// Treat the following two the same, but you don’t have to. 
case reqCompile: 
case reqCompileDebug: 
// Get at the options for this compile. For this example, they are provided as 
// a string, a laa command line! Very convenient! 
poptions = *((struct Options **)SPM_pintf->options; 
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// _SPM_cmdparseQ breaks up a string as if it were a command line, and fills 
// in the typical argv array of strings. It returns the number of arguments. 
// Note that we are providing the name of the program that was “called” as 
// the first argument. Remember: if this were called from a command-line, 
// argv[0] would be pointing to the name of the compiler executable! 
// This helps us avoid any special-processing in the rest of the drop-in source. 
strepy (args, "my_dropin_name_goes_here"); 
if (strlen(poptions->prefix) ) 
strcat (args, poptions->prefix) ; 


argc = _SPM_cmdparse (args, &aregv); 


// Since our original “mainQ” entrypoint returned 0 for a successful compile, 
// reverse the sense of its return value (SPM wants a 1 for success). 


success = !orig main (argc, argv); 
break; 
} /* end switch */ 


// If there was a problem completing the request, let somebody know. Depending on 
// your circumstances, you may wish to get more specific here. 
if (success == 0) 
SPM_pintf->shortMsg = "Something went wrong."; 


// Clean up after ourselves. 
__SPM_term (global_pintf, 1); 
return (success) ; 


This example is a bit simplified, and is very much like the 
example provided in the Toolkit documentation. The point is 
that this code provides a good starting point for any drop-in 
compiler port. Let’s go over some of the more important 
aspects of the example; then we’ll move on to what we 
specifically had to do for the mee drop-in. 


Options Processing 

Creating dialog boxes for options processing is probably 
not the most critical portion of any drop-in. You will have to 
do it sooner or later, but later may be a better choice if you 
don’t want this task interfering with your initial porting efforts. 

The example illustrates Symantec’s solution to the 
problem. In order to get you up and running as soon as 
possible, they provide you with the following C code, 
resources, and library routines to accept a string that can be 
treated like a command-line: 


e SPMshell.r — This contains all the basic resources 
(‘DITL', 'STR#', 'INFO', 'cfrg', etc.) you'll need to 
get your drop-in up and running. It also includes resources 
that gives you a “prefix” area to type in command-line 
options for your drop-in. 


e emptyoptions.h — The C source code needed to 
associate the 'CNFG' resources with the struct 
Options used in the example. 


If your command-line compiler originally used the 
argc/argv mechanism for processing command-line 
arguments, you can get a “command-line” from the prefix built 
into your drop-in (set in Options : <Name-Of-Drop-In>). 
Use the __SPM_cmdparse() library routine to break it up 
into an array of strings (argv) and to get a count of the 
number of arguments (argc). 
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This solution has worked out so well, we’ve still managed 
to put off the task of creating a real dialog box interface! 


System Resources: Heap Memory 

Symantec took pity on those potential drop-in translators 
that do a poor job of freeing up heap memory which they 
managed to allocate during a compile. If your drop-in uses 
standard ANSI library function calls to allocate heap memory 
(malloc(), calloc(), realloc()), Symantec provides two 
means for automatically freeing up all heap memory that your 
drop-in allocates. 

The first method is demonstrated in the example code. 
The call to ___SPM_term() is the key: 


__SPM_term (global_pintf, 1); 


The first argument is the SPM options block; nothing new 
here. The second argument is a flag telling _ SPM _term() 
to free up all heap memory allocated by the drop-in. 

The second method is a bit more explicit. Symantec’s 
PPCANSI library contains a routine called 
__malloc_cleanup(), which will free up all heap memory 
allocated up to that point by the current executable/shared 
library. If the organization of your drop-in allows you to utilize 
this routine, use it. Needless to say (but we're saying it anyway!), 
be extremely cautious when and how you use this routine. 


System Resources: Global Variables 

This wasn’t nearly the problem we expected it to be. For 
PowerPC native drop-ins, SPM utilizes the Apple Code 
Fragment Manager to re-establish a connection to the drop-in 
translator each time SPM invokes the drop-in. The net effect is 
that the drop-ins global variables are re-initialized and ready to 
go. While this does introduce a reloading penalty, in practice 
this has not proven to be significant. 


Enhancing the SPM with Your Drop-in 

“How does one present a new drop-in compiler to the 
SPM?”, you ask. The SPM looks for a folder called 
(Translators), in the same folder as the SPM itself. Any file 
of type 'TRAN' that SPM finds in the (Translators) folder is 
considered an available drop-in. SPM identifies translators 
internally by their creator ID, not by name; you must choose a 
unique creator ID for the SPM to distinguish between translators. 

Once this is done, SPM (upon startup) will include the new 
drop-in in the list of translators that can be utilized for your project. 
Choose the Options menu item and go under Extensions to 
associate your drop-in with a particular file extension (.c, .s, 
.xcoff, etc.). You will also find under the Options menu a 
specific options panel for your new drop-in, identified by name. 

Sounds quite simple: make a few quick modifications and 
voila! You have a brand-new translator drop-in for the SPM 
environment! Well, here are some of the things you would 
need to know, gathered from our experience porting mec into 
the SPM world. 
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SPECIFICS ON PORTING MCC 


“A nice overview”, you might say, “but not enough information. 
Heck, you haven’t even covered how to deal with C source 
files, how to pass back object files to the SPM, how to report 
errors...” All this is true. Now that we’ve clouded your minds 
with pages of terminology and issues, we'll get down to the 
nitty-gritty of what you need to really get the job done. 


mcc Organization 

mec is typical of many UNIX compilers in that the 
executable “mec” is a driver program that processes command- 
line arguments and calls other programs to compile your C 
program. This is true on every platform we've ported the 
compiler to, including MPW. Motorola’s compiler consists of 
five separate executables: 
mec — Driver program. 
cfe —C front end. 
ipa — Interprocedural analyzer. 
cor — PowerPC code generator, generates assembly files. 
pas — Motorola Portable Assembler; generates XCOFF object files. 


Unfortunately, SPM doesn’t support multi-executable drop- 
ins. We couldn’t simply create a single large executable that 
did all this work (well, we could have, but the changes to the 
base compiler source would not have been easy). In the initial 
phases, this appeared to be a major problem. However, a 
simple solution soon presented itself: make mec the drop-in for 
SPM, and turn the other compiler phases into shared libraries, 
each with a single exported entrypoint. This had the advantage 
of keeping all the global variables in each phase separate (there 
were five versions of curline and index). 

The SPM-specific portion of the mec driver looks very 
much like the example presented earlier, with the exception 
that the old_main() portion (read: the original mec driver) 
now calls library routines cfe_main(), ipa_main(), etc., 
rather than spawning off new processes to perform the 
compilation. Each of these library routine entry points still uses 
the argc/argv style of argument processing. 

A bit of advice: if you can, start with a small portion of 
your prospective drop-in and rehost it under SPM. In our case, 
we took our assembler, pas, and created a new drop-in 
assembler that translates Motorola PowerPC assembly language 
files. This drop-in assembler generated standard XCOFF 
objects, and helped us work out some basic issues while 
tackling a relatively small porting job. It was worth the effort; 
we managed to keep over 95% of the work we did on pas by 
the time we completed the entire mec port. 


File Management 

mec deals with three types of file when performing a 
compilation: source files, temporary files, and object files. 
SPM1ib provides abstractions for dealing with all three types 
of files that fit in very well with the overall mec source code. 


46 SPM, BE My Host! 





1 Finding Source Files 

SPM provides an easy-to-use abstraction for finding the 
source files to be compiled, whether they are on disk or in 
memory. If you know the name of the file to open, SPM will 
handle the rest. 

SPMLib provides the following callback routine: 

FILE * 

__SPM_opentextfile( 
struct Intf *pi, 


char *filename, 
int sys_incl, 


// Pointer to SPM options block. 
// File to open (C-string). 

// Non-zero if filename was part 
// of #include statement using 
// ‘<>’; 0 if ‘“”’ were used. 

int *SPM_fileno, // SPM internal file number. 
short *SPM_error); //Non-zero in the event of 

// any errors opening filename. 


Upon successful completion, __SPM_opentextfile() 
returns a FILE * to the open file. The drop-in needs to keep 
track of SPM_fileno if it needs to report any errors or 
warnings against the particular source file. 

A related routine, _SPM_opentextfilereplace(), is 
functionally equivalent to __SPM_opentextfile() but 
converts all "\n"s to "\r"s and vice versa. 

This interface reduced our source file management chores to 
a minimum. mec no longer needed to keep track of search paths 
for sources, nor did it need to get involved with any source-file 
caching schemes. Both of these jobs are best left to SPM itself. 


2 Temporary Files 

Like many other compilers, mec uses temporary files 
during the compilation process. In the UNIX environment, 
these files reside on disk, typically under the directory /tmp, 
and exist only while the compiler is running. When mec 
finishes, it cleans up all temporary files associated with that 
particular compilation. 

Using temporary files under the SPM environment appeared 
to be more problematic. One issue was where to put these 
temporary files. We were not aware of any standard folder that 
could be used by applications for temporary files. Another not-so- 
obvious issue was a bug in the SPM which manifested itself when 
using ANSI file I/O for disk files. Back in August 1995, we had 
managed to get a primitive demo version of mec running under 
SPM. This compiler performed no optimizations, and could barely 
compile our demo SillyBalls (a bouncing ball demo). Still, it 
was progress, and showed that we could host mec under SPM. 
This version of the compiler used disk temporary files residing 
under the Sym C++ for PowerPC folder. The compiler 
manipulated these temporary files just fine — opening, reading, 
writing, and closing the files was not a problem. Unfortunately, 
after running the compiler, we were not able to shut down the 
SPM; if we did manage to do so, the machine would crash! 

While neither Symantec nor Motorola had any idea as to 
why this was happening, it became a moot point. Symantec 
developed SPM1ib callbacks for creating memory-resident 
temporary files. This not only got around the bug, but improved 
overall compiler performance by avoiding disk accesses. 
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The new SPM1lib interfaces were: 


FILE * __SPM_opentempfile (void) ; 
Handle __SPM_closetempfile (FILE *); 
FILE * __SPM_openhandle (struct Intf *, Handle); 


__SPM_opentempfile() takes no arguments. It returns 
a standard ANSI FILE * which works correctly with 
Symantec’s PPCANST library. 

__SPM_closetempfile() accepts a FILE * to the file 
to be closed and returns a handle to the memory that the 
temporary file occupied. In this way, you can actually keep the 
contents of a temporary file around, if necessary, and re- 
examine the contents at any time. 

__SPM_openhandle() accepts a pointer to the Intf 
structure your drop-in currently is using, and a Handle you 
wish to open as a FILE *. A limitation to this routine that is 
worth remembering: you should only be opening a Handle as 
a FILE * for read-only! You cannot append to a FILE * 
that was created using __ SPM_openhandle(). 

These three routines allowed us to create a generic 
abstraction that replaced the normal fopen(), fclose(), 
fflush() and unlink() calls with ones that utilized the 
SPMlib interfaces. This allowed us to utilize memory-resident 
files without having to modify the vast majority of mec. 


3 Object Files 

Thus far, we’ve been able to open text files for compilation, 
and manipulate temporary files for use during compilation. 
How do we manage to hand object files back to SPM? 

The SPM IDE expects all final XCOFF objects to be in 
Handles. After your compiler is all done, if you were using 
ANSI I/O, you'll have a FILE * to an object file. If you were 
using Mac Toolbox I/O, presumably you’ve already called 
FSRead() to copy the file into a Handle and you can skip 
the next step. If you opened the object file using 
__SPM_opentempfile(), the result of closing the object file 
via__SPM_closetempfile() isa Handle. The next step is 
to take the Handle to the XCOFF object and process it using: 


PTHINKXCOFF txc_thaw (Handle); 


txc_thaw() takes a Handle that contains a standard 
XCOFF object file and returns a pointer to a THINKXCOFF 
data-structure (Symantec’s internal representation of XCOFF). If 
there was something wrong with the object data in the 
Handle, txc_thaw() returns NULL. This routine is part of 
Symantec’s thinkxcoff library. 

SPM provides a general-purpose callback for drop-ins to 
send the results of an SPM request back to the SPM itself: 

(void) _SPM_SendResult (struct Intf *, 

long int, // Result type:"XCO1’,etc.) 


void *);  // Pointer to Handle 
// containing XCOFF object. 


This routine can minimally accept result types of 'TEXT' 
(typically the result of a reqPreprocess request), 'XCO1' 
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(XCOFF object generated using txc_thaw()), and 'XCOF' 
(XCOFF object file libraries). Other result types may be 
possible; we have no experience with them. 

A related issue concerns the ability to utilize the SPM 
internal / incremental linker with mec-produced XCOFF object 
files. Symantec originally developed their own internal object 
file format for handling PowerPC code; the SPM internal linker 
was limited to using this internal format. Symantec has 
enhanced the latest pre-release version of SPM to handle mec- 
produced XCOFF object files. Work-in-progress includes 
supporting mec-produced debugging information for use with 
the Symantec debugger. This will provide mec with full 
integration within the SPM environment. 


Compiler Error and Warning Messages 

Most compilers have one or two central routines that deal 
with displaying error and warning messages to the user. These 
routines display the file name and line number where the error 
was found, display the error (or warning) message, and 
optionally display a portion of the offending source (context). 
Command-line compilers send the warnings and errors to the 
console (stderr) using fprintf£() calls. 

This is, of course, not done under the SPM environment. 
SPM provides a library routine with which to present errors to 
the IDE: 

(void) __SPM_error 

(struct Intf *pintf,// You’ve seen this before! 

char *perrmsg, // C-string; body of error message 
int warning, // kError, kWarning or kDebug. 
int lineno, // Line number of offending source. 


int fileno) ; // SPM internal file number of 
// offending source. 


The string perror may include multiple lines separated 
with the 0xD character (\r)). The warning parameter derives 
its value from the __SPMErrorType enumeration, declared in 
SPMlib.h. The fileno parameter was obtained via the call 
the drop-in made to __SPM_opentextfile() or 
__SPM_opentextfilereplace(). 


Cooperative Multi-Tasking 
Users may wish to do other work while some application 
is compiling in the background in SPM. At the very least, your 
drop-in needs a way to share processor cycles with SPM, as 
well as allow the user to interrupt a compilation in progress. 
int __SPM_ReportProgress 
(Struce Int? * pinet, 


long num_lines);  // Total # of lines 
// currently compiled. 


__SPM_ReportProgress() should be called many 
times from your drop-in. If the drop-in you are porting is 
fortunate enough to be coming from the MPW environment, 
the hard work of identifying appropriate places to call 
__SPM_ReportProgress() has been done for you. In 
general, you can simply replace calls to the MPW routine 
SpinCursor() with calls to__ SPM_ReportProgress(). 
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How many times to call __SPM_ReportProgressQ is an 
interesting issue. Too many calls will drag down overall drop- 
in performance, while too few calls will give the user sluggish 
response from the IDE. The following code fragment roughly 
represents the code that mec uses to resolve this issue. 





Listing 2: Interface to call _ SPM_ReportProgressQ) 
#tdefine HZ 60 


void 
mec_multi_task (struct Intf *SPM_pintf, int total_lines) 
{ 

static unsigned long last_time; 

static int num times. — 0; 

/* Each “tick” is about 1/60 of a second. */ 

unsigned long now = TickCount(); 

int num_to_report; 


if (now - last_time > HZ/10) { 
last_time = now: 


/* If we are the C front end, give the number of source lines that have been 
processed thus far. If we aren’t (i.e. we’re in the code generator), report a 
“heart-beat” to let the user know that the compilation is still taking place. 


* 


#tifdef C_FRONT_END 

num_to_report = total_lines; 
fFelse 

num_to_report = num_timestt; 
fendif 


/* If the user has interrupted the compilation process, call mcc’s local exit. 
This is NOT a call to the real exitQ routine! */ 

if (__SPM_ReportProgress(SPM_pintf, num_to_report) != 0) 
{mec_local_exit (1)}; 


We had previously solved this problem when mec was 
hosted under MPW; the call to __ SPM_ReportProgress() 
was a call to SpinCursor(). This call never appears directly 
in the mee source; a macro is used instead to allow for easy 
exclusion of the call for host platforms that don’t require this 
sort of routine. 

It’s best to experiment a bit with the number of times you 
call _ SPM _ReportProgess(). We found that for mec, a 
good number was about 10 times per second. This allows for 
reasonable system response while not throttling the compilation 
in progress. 

One small sideline: mec compiles source differently from 
the Symantec compiler. Symantec will compile C source code 
one function at a time; when SPM reports that it has compiled 
1000 source lines, you can count on that figure. mec, on the 
other hand, will go over the entire C source file with the C 
front-end first, generating an intermediate representation that is 
later processed by the optimizer and the code generator. Since 
code generation takes up the majority of processing time for 
mcc, it appears to users that the compiler has “frozen” under 
SPM when the line number count stops incrementing. 

The conditionally compiled code in mec_multi_task() 
is the majority of the solution. Calls to mcc_multi_task() 
from mec’s front end pass the appropriate line number along 
for display. When the front end finishes, it saves off the total 
number of lines processed. Calls from the code generator then 
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display a sequential count, rather than line numbers, to indicate 
code generation progress. When the compilation process is 
done, the mec driver makes a final direct call to 
__SPM_ReportProgress() with the final source line count; 
this is the value that SPM adds to the Total Lines field of its 
(compilation) Progress window. 


CONCLUSIONS 

Symantec has provided a robust set of callbacks to support 
non-Symantec tools under SPM. The entire process of porting 
mec into the SPM environment was a rewarding one. In 
retrospect, it wasn’t difficult, and was certainly worth the effort. 
Experienced Mac OS developers should have an easy time 
dealing with the SPM porting requirements. We certainly 
encourage tools developers to port their software to run under 
SPM. Symantec provides an excellent user interface, and there 
is no need to “reinvent the wheel”. 
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By Don Crabb 


I am sitting here on the beach in Aruba reading a copy of 
Caribbean Week. 1 know, I know, it’s a dirty job, but I have to 
do it! Anyway, I’m sitting here trying not to spill my pina 
colada on the paper or on this PowerBook 5300ce (which tends 
to react rather poorly to cold alcholic beverages poured into the 
keyboard), when I hit upon an Apple ad (page 17, 1/3 page, 
four-color, for those who care) for the Performa. 

The ad asks if I “Need help with your work?” And 
answers its own question with, “Then you need a computer 
that works as hard as you do.” These tag lines float above and 
below a photo of a beleaguered-looking guy at his desk, awash 
in stacks of paper, as he is clearly burning the midnight oil 
without a computer in sight. The ad further tells us with color 
highlighted tags that the Macintosh Performa is “Easier to use” 
and “More Affordable” as well as “#1 in Multimedia in the 
World.” The Performa is also hailed for its “integrated 
Software” and “CD-ROM”. 

The ad’s body copy is clean enough: 


“Welcome to Macintosh Performa, the complete 
solution that offers you the best return for your 
investment. Fax information to your clients or contact 
them through e-Mail and use the CD-ROM to help you 
create and author your own spectacular multimedia 
presentations. And perform many other operations 
easier and faster than with any other computer. 

“Macintosh Performa also reads DOS and Windows 
files, and includes many bundled software titles and CD- 
ROMs for your business and entertainment needs. It’s 
easy to install, and like all Apple products, very easy to 
use. At your fingertips you have options that include 
creating 3D graphics, video conferencing, or virtual 
reality. No other computer does so much for so little 
because it’s not only what the computer can do, it’s 
what you can do with a Macintosh. Apple. The Power 
to be your best.” 


OK, why I am on going on about what seems like a pretty 
standard Performa ad, albeit in a pretty nonstandard place, 
Caribbean Week? 








Because this ad is a mess, and it’s advertising like this 
that is hurting Apple’s developers by sending either wrong or 
misguided messages to potential customers. Apple can’t 
afford to waste any more of its marketing money on this sort 
of unfocused ad du jour. Here’s why and what they should 
do about it. 

First of all, Apple, no more ads that don’t focus on a single 
theme. Stop the mixed messages and the “all things to all 
people” nonsense. This Performa ad shows us a paper- 
bedraggled office worker working without the aid of a PC. Yet 
your ad copy touts the Performa’s ability to “perform many 
other operations easier and faster than with any other 
computer”. Damn, the poor guy in the ad could work smarter 
and faster if you gave him an old 128K Mac, let alone a 
Performa! But not only do you tout the Performa’s ability to 
kick the ass of mere mortal machines, it can also kiss their ass if 
need be: “Macintosh Performa also can read DOS and Windows 
files.” Well, yippy, skippy! 

Leaping from a poor slob with no PC in sight to amazing 
feats of computation and competitor cooperation is also just 
plain dumb. 

Oh, but I digress. Let’s get back to the ad copy. Consider 
the first graph body copy. The tag there tells us, “Welcome to 
Macintosh Performa, the complete solution that offers you the 
best return for your investment.” Fair enough. A good line to 
play off the picture of the paper-bedraggled office guy. But 
then read how you get off that track and onto the current Mac 
mantra: “Fax information to your clients or contact them 
through e-Mail and use the CD-ROM to help you create and 
author your own spectacular multimedia presentations.” 

This ad is running in Caribbean Week, not the Wall Street 
Journal. Faxing may be hot in Europe, the Far East, and the 
States, but faxing in the Caribbean is not nearly so widespread. 
Remember, these are islands here. Each with its own phone 
system and interisland tariffs. So, while you may find 
intraisland faxing big on Aruba, just trying to find a working 
phone on Nevis or St. Kitts may be the order of the day. 

But as suspect as the faxing line is, the notice of building 
“spectacular multimedia presentations” just floored me. I am 
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still laughing at that one. And so is the guy sitting next to me 
here on Aruba. He happens to be the manager of the hotel I 
am staying at. I showed him the ad, and he’s rocking. I asked 
him how many “spectacular multimedia presentations” he 
needed to do this week, and he laughed even harder. You see, 
he doesn’t need CD-ROMs, or e-Mail, or fax modems, or the 
ability to read DOS and Windows files, or video conferencing, 
or 3D, or virtual reality (believe it or not). He needs reliable 
computers and a server networked together in his hotel’s 
business office so he can keep track of his guests, his rooms, 
his staff, his inventory, and the thousand other basic business 
tasks he attends to each day. 

After all the laughter subsided, I asked him what sort of 
computer systems he had in place, and why. “Let me show 
you,” he said. So I took a look. He had a very new Compaq 
Pentium Pro server driving 14 different Pentium workstations, 
all with the same prebuilt menu offering the task choices his 
people needed. I noted that none of those tasks were virtual 
reality, 3D, video conferencing, or even spectacular multimedia 
presentations. No, the manager said, none of the things Apple 
touted in its ad were the capabilities he needed at his hotel. 
And he doubted that many other business people on Aruba 
would be much impressed with those Apple features, either. 
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So, I decided to do a little survey. I hopped into my rental 
car and spent an otherwise pleasant sunny afternoon checking 
out other hotels, stores, restaurants, even some government 
offices and a couple of schools. I couldn’t find a single 
manager who thought any of the Performa’s advantages would 
matter a tinker’s damn to them. To a person, the story was the 
same: they need computers that are reliable at accounting, 
database, word processing, inventory, and related basic 
business chores. A few were excited that such things as 
spectacular multimedia presentations might be coming down 
the road for them, but they doubted they’d buy Macs just to get 
those features. “Besides,” one asked, “won't the PC guys have 
that stuff too?” 

OK, let me move from the case of the Performa ad to the 
larger problem of Apple marketing and advertising. Since 
forever, Apple has tried to bite off more than it could chew. 
Nothing wrong with that in some respects, but when the entire 
company works that way, it becomes a serious problem. Apple 
advertising is a good example. It must stop trying to invent the 
need for everything “hot” the Mac can do, and sell the basics 
that its markets need. 

Futher, Apple needs to figure out precisely where its 
market are and where it would like them to be, and then target 
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cell margins, top/bottom & left/right 

68K support for both A4 and A5 worlds 

“LDEF-like” custom drawing function 

greater than 32K data per table 

plus all List Manager functions and more 


. StoneTableExtra 
drag cells in and between tables 
PICT support 

popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 

controls in cells 
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those markets with advertising that speaks to their issues, not 
ads that have stale boilerplate copy ladled into them like one 
ladles old soup into a fresh pot in the hopes the restaurant 
patrons won't notice. 

Well, Apple, your patrons are noticing. You're leaving a 
bad taste in the mouths of those who have already been seated 
at the Macintosh table, and you're putting off potential diners 
because you keep giving them menus that don’t make sense — 
rare char-broiled steak served cold with a side of chocolate ice 
cream, preceded by an appetizer of peanut butter and jelly 
sandwiches, washed down with a Lafitte 65. The individual 
items are great, in and of themselves, but the complete menu is 
a disaster. 

Apple, you need to get your master chef to crank you out 
some sensible menus. Until then, too many potential customers 
will be dining elsewhere. Or laughing at your menus... 
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Expert 4D Programmers 
Less than 50¢ per hour! 


- More than 1,000 hours of development went a 
AD Toolkit 2.0. With a one time price of $395 
E ies like hiring a crack team of 4D eae . 
less than 50¢ per hour. Call 1-800-736-3 
ive a free demo. 


order your copy, or to rece 
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New York, NY 10014 
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FAX: 212-633-0336 





* upgrade pricing available 


CRABB’S APPLE EI 











E For Windows. 95 AND WINDOWS NT... WORKSTATION 


| VERSION 4. 





Add-On for 
Macintosh. 
and Power 
Macintosh. 


Bring out the best in both worlds. 


Using just one toolset to target multiple platforms, you can 
increase your user base and knock months off your develop- 
ment time. With Microsoft® Visual C++™ Cross-Development 
Edition for the Macintosh*, you can reuse up to 90% of your 
code from your Windows-based applications to create the 
same applications for the Macintosh®, with the familiar 
Macintosh interface. 


Features Include: 

Mm Port Windows®based features easily to the Macintosh, 
including multiple document interface, print preview, and floating 
toolbars. The Windows Portability Library does the work for you. 
M@ Jrue native Macintosh programming. Program directly to 
the System 7 API to take advantage of unique Macintosh fea- 
tures such as Publish and Subscribe. 

mM Recompile for the Mac™: Target both the Windows and 
Macintosh operating systems using just one set of source 
code written to Microsoft Foundation Classes and the 
Microsoft Win32® API. 


“This add-on toolset requires Visual C++ for Intel® platforms, available separately. 


mM Power Macintosh™Support: Including a fully optimizing 
compiler and integrated debugger that adapts to the 
PowerPC™ chip when displaying information in the register 
contents and disassembly windows. 

M Code Fragment Support: for the Power Macintosh which 
translates to better code sharing among applications and 
faster, trimmer applications with very little development over- 
head. 

M@ OLE support: You can now easily port your Win32 and 
MFC OLE applications to the Macintosh using OLE for the 
Macintosh version 2.06. 

M@ ODBC support: You can call ODBC directly or use it 
through the appropriate MFC classes. 
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By Paul Snively 


Revisionist History 


Organic tools for an 
unpleasant task 





RATIONALE 


Revision control is often neglected. Of 
all the companies I’ve been with, only 
three have even attempted to use it — 
and at two of these, the decision was 
driven by engineers on particular 
projects, sometimes with the result that 
projects couldn't share files because their 
revision control systems weren't 
compatible. Don’t get the idea that I’m a 
great lover of revision control, either. 
I’ve always found RCS, Projector, and 
previous versions of SourceSafe to be so 
confusing and unwieldy as to be more 
trouble than they were worth for groups 
of anything less than about five users. If 
I hadn’t found a couple of systems worth 
writing about, this article wouldn’t exist. 
Nevertheless, two observations 
about software development today will 
demonstrate the pertinence of the 
subject. First, many of us are doing 
cross-platform development and 
struggling to maintain feature-for-feature 
compatibility between platforms. 








Second, a lot of what we professional programmers do these 
days isn’t so much original development as synthesis — taking a 
collection of code, some of which we wrote and some of which 
we didn’t, and gluing it all together, making whatever changes 
to the pieces prove necessary along the way. A revision control 
system becomes indispensable in cases where you have to track 
common code vs. platform-specific code and in cases where 
you're using some existing code and making changes to it 
(possibly at the same time that the original author makes 
changes to it!), And of course, you could be trying to do both 
at the same time. 

Note that neither of these common scenarios has anything 
to do with having multiple programmers on a project. These 
are situations that I, and probably you, have encountered even 
when we're working on things all by our lonesome. Don’t be 
seduced into believing that revision control is only for projects 
involving large groups. 

Many of you may have prior experience with one of the 
older revision control systems — Projector/SourceServer for 
those of you who cut your teeth on the MPW or Symantec 
environments, SCCS or RCS for us greybeards in the industry. 
I'd like to take a look at a couple of relative newcomers to most 
of us, even though they’ve both been around for a while: 
Metrowerks’ CodeManager, née SourceSafe, and UNI Software 
Plus’ VOODOO. 


Is It SAFE? 
CodeManager 1.0.3 (DR1, with patches available at 
htto://www.metrowerks.com/tools/software/updates/cm1) is the 
Macintosh version of SourceSafe, which was purchased some 
time ago by Microsoft. As a result, one of CodeManager’s major 


Paul Snively has been around the block a few times — as project leader on ICOM Simulations’ last MacVenture, “Deja Vu II: 
Lost in Las Vegas”, as code contributor and user’s guide author for the TMON 2.8 debugger, a stint in MacDTS, writing a 
Kermit tool for ClarisWorks at Claris, developing a student-oriented word processor at The Learning Company, working on 
OmniScan Direct at Caere, and porting the recently released “Spycraft: The Great Game” to the Mac at Activision. If he’s 
learned one thing in all of this, it’s that revision control is his friend. These days he’s Director of Technology at Digital Planet, 
Inc., 3555 Hayden Ave., Culver City, CA 90232. You can snail-mail him there, check out Digital Planet’s home page at 
http://www.digiplanet.com, e-mail him at psnively@digiplanet.com, or MaBell him at (310) 287-3636 x127. 
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Draginstall. 2.0 


Here’s proof 


that the more things change 


A New “Quick Build” option lets you build a 
complete installer in one easy step. 

A New features such as locating files and folders, 
applying patches, and replacing outdated files 
allow you to build more intelligent installers. 

& Improved support for installing non-archived 
files simplifies the creation of CD-ROM and 
network installers. 

A& PowerPC-native compression and 
decompression cuts installation time in half. 

A AppleEvent and scripting support allows 
installations to be automated. 


the more they stay the same 


Vv Same price-$300 lets you distribute an unlimited 
number of installers for all of your products. 
No yearly fee, no royalties, no hidden costs. 

Vv Same drag-and-drop interface familiar to all 
Macintosh users. 

Vv Same reliability and robustness that developers 
worldwide have relied on since 1991. 

Vv Same support policy—free technical support and 
low (or no) cost upgrades. 


For more information or a free demo, call 


1-800-890-9880 


or visit our Web site at 
http: //www.sauers.com/draginstall 


Ray Sauers Associates 
1187 Main Avenue, Suite 1B 
Wey Clifton, NJ 07011 USA 
Associat@s voice: 201-478-1970 


fax: 201-478-1513 
email: info@sauers.com 
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selling points is its cross-platform availability. Unfortunately, one 
aspect of CodeManager that eases the burden of keeping it cross- 
platform is that it is a command-line system — that is, it runs as a 
set of tools under MPW or ToolServer. This is probably not so 
bad if you’re an old hand at SCCS/RCS/Projector, especially if 
you're still an MPW user anyway. As a CodeWarrior user since 
DR/1, though, I can afford neither the disk nor the RAM space to 
maintain both CodeWarrior, CW8 and MPW at the same time, so I 
had to get ToolServer up and running under CodeWarrior. That 
alone was a sufficiently daunting task that it nearly made me give 
up on CodeManager, which would have been a shame, because 
there are things to like about CodeManager. Hint to you: if 
you're going to install CodeManager under ToolServer, don’t 
forget to rename UserStartup*CodeManager to 
UserStartupTS*CodeManager. Hint to Metrowerks: most of 
your CodeManager users are also likely to be CodeWarrior users, 
so how about providing an installer that will install ToolServer 
and CodeManager into an existing CodeWarrior installation and 
then delete the desktop file(s) before restarting, thereby forcing 
the Finder to rebuild the desktop? 

Once I got CodeManager up and running under ToolServer, 
I was pleasantly surprised to find that it doesn’t remind me as 
much of SCCS/RCS/Projector as I had expected it to. 


Projects vs. Files 

Historically, revision control systems that I’ve used have 
been file-centric: useful for tracking changes to any given file in 
a project, but poor at tracking changes to the project 
(integrating one file’s contents into another, renaming a file in 
the project, renaming a folder, moving a file from one folder to 
another, etc.). If you’ve spent any time wrangling any but the 
smallest project, you probably know that getting the structure of 
the project right is at least as difficult as getting the content of 
the project right. 

CodeManager, to its considerable credit, is project-based. 
Not only does it support traditional file-level revision control, 
but groups of files belong to projects and can be referred to 
collectively. Projects can be nested, and in this sense projects 
resemble folders. Unlike folders, however, projects can be 
deleted and later recovered. 

Projects can also share files - an update to a file in one 
project is automagically reflected in the file in any other projects 
that include it. This feature is especially handy when you have 
multiple projects that rely on a common code base. As long as 
the common code is shared among all the projects that use it, all 
the projects are kept up to date without any extra effort. 

It may be the case, though, that your project is using code 
from someone else’s project and your schedule is somewhat — 
ahead of theirs. You may need to freeze your project before 
they do. That’s ok — you can “pin” whatever file(s) they’re | 
sharing with you at any version at any time. This doesn’t break 
the shared link; it just gives you a specific “snapshot” of the 
revisions of that file. You can unpin the file at any time to catch 
up to the other revisions. 
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In a similar vein, you can “branch” a shared file if you need 
o revise it in directions that you know differ from those of the 
bther sharers of the file. Unlike pinning, branching does break 
he shared link. However, a history of the link is still 

aintained, so you can examine the common heritage of the 
branches if you need to. 

As you might expect, CodeManager also allows you to 

erge branches of a file, in the event that the combined 
revisions would be appropriate for all projects sharing the 
branches. It’s perhaps worth pointing out that CodeManager 
an handle both text files and binary files, although its means 
for determining which is which is questionable: it reads the file 
and, if and only if it discovers any zero bytes, considers it a 
binary file. This behavior can be overriden with an 
environment variable that specifies, say, that all files whose 
names end with .sit, .u, or .rsre are binary files, and all 
others should be considered text. There are also command-line 
options to the relevant commands to specify that when 
comparing files both forks are to be compared. CodeManaget’s 
ability to do diffs and merges on binary files is one of the things 
that set it apart from earlier revision control systems. 

My favorite project-based feature, though, is labels. You 
can attach a label to an entire project at any point in the revision 
of that project, and then, at any point down the road, you can 
retrieve the entire project by label. The most obvious 
application of labels to me is at major milestones: when your 
project goes alpha, give it a label saying so; when it goes alpha 
two, label it; when it goes beta, label it. This way you have an 
air-tight history of your project’s milestones, which can be 
extremely helpful in analyzing the project’s schedule, budget, 
size, feature set, bug history, etc. In particular, imagine how 
much your QA staff doing regression testing will love being able 
to retrieve any version of the project any time they need to. 

Finally, a feature that is, as far as I know, completely 
unique to CodeManager: you can configure it in such a way that 
multiple people can check out a file at the same time, and 
when the various users of the file check their revisions back in, 
CodeManager will attempt to merge them. If none of the users 
have modified the same line, then the merge is considered to be 
without conflicts and happens silently. If, on the other hand, 
two or more users have modified the same line, then whoever 
checks their revisions in later will have the opportunity to 
resolve the conflict, hopefully in consultation with whoever 
checked in the earlier revision. Many’s the time I’ve wished for 
a revision control system that recognized that it’s quite rare for 
my coworkers and myself to be working on the same lines in a 
source file, but it’s relatively common for us to need to work on 
the same file. CodeManager makes this as painless as I think it 
can realistically be made. 

Administration of CodeManager is a straightforward matter 
of editing some text files and possibly using some extra tools 
once you have logged in under the Admin account. I 
encountered no particular surprises here, good or bad. 
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1-2-3 Start Tracking 
TestTrack is ready to use 

right out of the box— 
simply install, add a few 
users, and start tracking. 
It’s that easy. 


Bug Tracking the Macintosh Way 


TestTrack is more than an easy-to-use bug tracking program—it’s a powerful quality control 
tool for busy software development teams: 


Automate TestTrack automates the Communicate TestTrack links engineers, 
tedious and error-prone process of testers, managers, even tech writers together 
reporting and tracking bugs by hand. It so no one falls out of the loop. Team 

also eliminates the need to create a members are notified automatically when 
custom solution using general purpose defects are assigned to them, guaranteeing 
database tools such as 4D™ or communication and ensuring efficient work 
FileMaker Pro™. flow. 

Stay up to Date TestTrack lets any Analyze ‘TestTrack makes reporting easy— 
authorized user look up the current point, click, print and read. Customize 

state of any defect at any time. reports to list what you want to see. 


| For a limited time, you can buy TestTrack for the introductory price of $99! 


Volume pricing, and site licenses are also available. 


To order call 513-683-6456 


Seapine Software, Inc. 1066 Seapine Ct. Maineville, OH 45039 


OTANI KS 


http://www.seapine.com 


Why suffer 4GL limitations ? 


Often a 4GL causes as many problems as it solves 
- how much time have you spent wrestling with 
limited features, and still not got the interface you 
wanted? If you've grown to love the flexibility 


of c++ and tools such as 

—) PowerPlant and AppMaker, 
then OOFILE is for you. 

OOFILE works with your 

tools, adding database and 
presentation features to 

compete with 4GL's. 


EUROPE: Full Moon Software. sales@fullmoon.com. Ph: +44 1628 660 242 
AUSTRALIA: Techflow. sales@techflow.com.au. Ph: (02) 9971 4311 
http://www. highway 1.com.au/adsoftware/ 
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The reason we call StuffIt 
InstallerMaker 3.0 the Complete 


Installation Solution is because 


we include CVELYUNAG Vi UCU to prepare a professional 


package of files for installation on your user’s machines. An installer, 
updater, and an uninstaller are just three components include 
for the same price one of our fine competitors charges for just 
the installer. Using our installer reduces technical support 
calls due to end-user errors during installation, saves disks 
(if distributing on floppies) or download time (if distributing 
on-line). You will save more than the cost of the Installer license by 
significantly reducing distribution costs. And the puzzle will be solved. 
You'll have every piece in place. 
fully-functional copy of 
StuffIt InstallerMaker 3.0 from www.aladdinsys.com 
or call (408) 761-6200 and ask for Developer Sales. 


© 1996 Aladdin Systems, Inc. 165 Westridge Drive, Watsonville, CA 95076. Fax: (408) 761-6206. Internet: cust.service@aladdinsys.com 
AOL, AppleLink: ALADDIN. Stuffit InstallerMaker is a trademark of Aladdin Systems, Inc. Other products are trademarks of their respective holders. 
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DEJA VOODOO 


VOODOO 1.7, from UNI Software Plus in Austria, takes a 
similar tack to CodeManager in that it is project- rather than 
file-based, and also stores deltas of either text or binary files for 
space-efficiency. VOODOO, however, takes the project-based 
concept a step further by supporting the notions of a 
component, a variant, and a revision, all of which are 
orthogonal to each other - VOODOO stands for “Versions Of 
Outdated Documents Organized Orthogonally,” which beats 
“BASIC” for the Most Tortuous Acronym award. “Orthogonal” 
just means that each of these concepts is treated independently 
of the others: in other words, VOODOO cleanly differentiates 
among the components of a project, the variants of those 
components, and the revisions of those variants. 

For example, let’s say that, being serious about what you 
do, you do all of your development on your PowerMac with no 
optimizations on — especially instruction scheduling, because 
that totally wrecks the mapping from your source code to your 
object code, and Metrowerks’ debugger gets confused (no slam 
to Metrowerks; practically any source-level debugger gets 
confused in the presence of instruction scheduling). Of course 
you generate a .SYM file, and maybe you even include 
traceback tables because MacsBug now groks them. Of course, 
your code is big and slow, but that’s because it’s your 
development version. On the other hand, by the time you’re 
ready to ship, it’s out with the traceback tables, out with the 
SYM file, and hopefully in with the instruction scheduling, 
global optimizations, etc. 

That’s one component — the project file — with two 
variants, debugging and optimized, and some number of 
revisions of those variants, such as when you try the level-four 
global optimizations and they cause your project to crash, so 
you scale down to level-two global optimizations and 
everything works fine. 

This may sound like a lot to keep track of, and it is, which 
leads me to another favorite feature of VOODOO, namely its 
graphical interface. As an example, consider McKinley. This is 
my shot at creating a Netscape 2.0 plug-in that supports VRML 
2.0 and the “Moving Worlds” proposal from Netscape, Silicon 
Graphics, and Apple, with object behaviors being pro- 
grammable in Scheme. In the McKinley project, there are four 
distinct major subsystems, namely Apple’s freely available 
3DMF parser, the freely available Mesa 3D graphics library, the 
freely-available MzScheme Scheme interpreter, and the freely 
available Netscape plug-in shell. With all of these sources 
yanked off the net, it’s a great project for revision control. 
VOODOO's graphical representation looks like Figure 1. 

The plain rectangular boxes are structure nodes. Like 
folders on your disk, they’re there to help you keep organized. 

The rectangles with the document icons are components. 
A component typically maps onto a file, and in fact VOODOO 
simplifies that mapping by allowing you to add files to your 
project as components. VOODOO will also allow you to drag 
and drop files into your structure nodes as you're defining the 
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structure of your project. Symantec users, rejoice! You ca 
drag files directly from your project files into VOODOO 
CodeWarrior users, grumble! You can drag and drop files int 
your projects, but not out. Interestingly enough, VOODOO i 
also a drag-in-only proposition. (An analogy with Roach Mote 
suggests itself.) 
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Netscape Plug-in Shell 
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MckKinleyPPC.p.exp 





Figure 1. How a VOODOO project looks 


The circles are used to indicate the variants of a 
component. In the McKinley project, you can see that of the 
visible parts only the project files themselves have more than 
one variant, debugging and optimized, as described above. 
Source files might too, however — for example, if you wished to 
maintain a variant of your source with debugging-assistance 
code included vs. one without. In the shot above, each variant 
actually refers to the same file. When you actually branch off a 
new variant of a file, it looks like this: 


Debugging 
Optimized 
Debugging 
Optimized 


4 
rs 
as 


MeokinleyéSk 





McKinley PPC. 





Figure 2. Two variants referring to one object 
us. an object for each variant 


The free-standing document icons are called version 
groups. In the 68K case, there’s only one, because the 68K 
optimizer doesn’t break the debugger so badly. In the PPC 
case, there are two, to indicate that the debugging and 
optimized variants refer to two different objects. This takes a 
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ittle getting used to, but it’s very convenient to be able to 
asily specify whether you want a development variant or a 
roduction variant of your project. Variants might also be used 
or those components of your project that just can’t be 
ompletely identical across platforms (you might have a 
acintosh variant and a Win32 variant, for example). 

Finally, you’ll notice that some of the structure nodes have 
rrows extending from them. This indicates that they have 
hild nodes, but that those nodes are currently collapsed so as 
o allow you to focus on the portion of the project at hand. 
Once you’ve defined the structure of your project, actually 
sing VOODOO to store and fetch components is simple. After 
aking changes to files, you can just drag them to the 
OODOO project window to store them and VOODOO will 
automatically figure out where in the tree they go. Failing that, 
you can use a dialog to select which components to store, 
specify locking of local copies, and the like. 

Fetching components is practically as easy: you can select 
any structure node, a component node if it doesn’t have more 
than one version group, or any version group icon, and fetch 
the most recent version(s) of those components, specifying in 
the process whether you want the relevant version group(s) 
locked, etc. 

Being project-based, VOODOO also tracks the history of 
the project as a whole: you can view structure changes, data 
changes, or both. As with CodeManager, you can name 
particular points in time (called “Defining a Configuration” in 
VOODOO), and when viewing the history of the project, you 
can roll back instantly to any such named point in time. 


CONCLUSIONS 
Revision control has come a long way since my 
SCCS/RCS/Projector days. It’s good to see two systems that 
take a holistic stance toward projects, recognizing that a project 
that I call “1.0b1” consists of some components that have been 
revised 100 times and others that haven’t been at all. And it’s 
nice that they both deal with binary files as well as text. 
CodeManager does some things that I’d love to see in 
VOODOO. The feature of allowing multiple checkouts of text 
files and making an effort to merge them together upon check- 
in is a big win for me. Generally speaking, VOODOO’s 
uniform treatment of everything as a binary is elegant, but 
some kind of comparison/merging facility would be a big help. 
And if you work in a mixed shop, SourceSafe/CodeManager is 
very hard to beat. 
On the other hand, VOODOO does some things that I’d 
love to see in CodeManager. Being a standalone application 
with a graphical interface and drag and drop support is one. 
Also, there’s its uniform treatment of variants as well as 
revisions (although careful use of branching in CodeManager 
could probably accomplish the same result). 
Personally, I use VOODOO on an everyday basis. It’s the 
tool that got me religious about revision control in the first 
place. It makes revision control make sense to me, and makes 
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The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
_ embedded systems, 
ane practically anything 
else, period. 





Robust, 45-Function API DOS $249 
Buffer and File Compression Winlé $299 
Portable Archives and Data Win32 $299 


Disk Spanning OS/2 $349 
Encryption Unix $349 
Self-Extracting Executables Macintosh $349 
On-line Help 


Full C Source Code FREE DEMO 


Tel 606-268-1559 


; Fax 606-266-0726 
DC Micro info@dcmicro.com 


ES Development http://www.dcmicro.com 


Call 1-800-775-1073 








it a fun process rather than a chore. Some time ago, in 
responding in netnews to a query about revision control, I said 
about VOODOO: 

“I use VOODOO 1.6 practically every day, and I continue 
to be amazed that it took this long for revision control to 
become even reasonable, let alone pleasant. VOODOO 
recognizes that not all the world is a text file. It recognizes that 
variants are distinct from revisions. It recognizes that I’m using 
a windowing system with a mouse. At this point, no matter 
where I go, no matter what other development tools I’m using, 
I'll be using VOODOO to keep me from shooting myself in the 
foot when it comes to version control.” 





To receive information on any products 
advertised in this issue, 


send your request via Internet: 
productinfo@xplain.com 
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By Christoph Reichenberger 


Do do that VOODOO... 


ORGANIZING VARIANTS AND REVISIONS 


The importance of software version 
management increases with the size of a 
software project. The implementation of 
large projects produces program families 
(programs existing in many different 
variants and revisions). Therefore, all 
components of a project (source texts, 
documentation, pictures, etc.) must be 
stored in many different versions, and 
have to be retrievable at any time. 

A drawback of many version 
control tools (SCCS and RCS, as well as 
most of their derivatives like DSEE, 
ClearCase, Projector/SourceServer, etc.) 
is the failure to distinguish variants and 
revisions. This is called intermixed 
version organization. Here, variants 
and revisions of components are 
organized together in version trees. 
Variants are generated by branching off 
new revisions from certain points and 
developing them in parallel. The 
component forms the center of 
attention, and the different versions of 
the components are managed by 
maintaining a single version tree for 
each component. This results in two 
main shortcomings: 








Keeping Things Straight, Orthogonally 


e Revisions and variants are identified by means of a multi-digit 
number. When a variant is split off, two more digits are 
appended to the version number. Especially in projects with a 
couple of variants, this numbering scheme becomes unwieldy. 

e The tree’s structure represents the chronological order of 
branching of variants. As the components’ histories of 
development will in general be different, distinct tree 
structures arise within the project, all representing the same 
variant information. The user of the software version 
control tool must know each of these structures in order to 
retrieve the specific variants and revisions of the 
components to be worked with. Moreover, these trees soon 
become difficult to survey when the number of variants of 
the project increases. 


Let’s take an example. Suppose there is a project 
consisting of two components A and B. At the beginning, this 
project is implemented in Modula-2 on a Macintosh computer. 
Some revisions of A and B arise. Figure 1 shows the version 
trees for A and B that would evolve when managing this project 
with SCCS at instant 0. 





Figure 1. The project's version trees at instant 0 


Next we need to implement a variant of the project in 
Pascal and branch off a new variant of the component A for the 
Pascal implementation, where the programmers expect that 
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Help Wanted 


Join the best virtual engineering team in 
the industry! The Now Utilities™ Team 
needs engineers and utilities for: 


¢ Now Utilities 7.0 
We need new utilities and engineers to 


enhance existing utilities 


¢ Now Utilties for Copland 
We need new utilities for Copland 


° Now Utilities Plug Ins™ 
We need new Plug Ins for Now Utilities 
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Utilities distribution 
can provide. 


_Now 


NOUAAlIS 


http://www.nowsoft.com 
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utilities@nowsolt.com. 








ALL BUGS ARE STUPID. 


But spending tedious hours trying to track them down is dumber still. 
Why not let a tool do the work? QC can find many of those mistakes 
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Every programmer makes mistakes. “ 
All programs ship with bugs. 
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a, 


QC is cool and, unlike other development tools, QC is easy. Try it FREE: 


|. Connect to our web site 

2. Download QC (less than 200K) 
3. Send us email to get a serial # 
4. Run the installer 

5. Run your program 

6. Press shift-option-q 


“I only have 6 non-Apple Control Panels on 
my development machine. QC is one of 
them. ‘Nuff said.” 
-Bill Goodman, Compact Pro author 


“We wouldn't ship a product 
without QC's approval.” 
-Mate Gross, Claris Corporation 


NOW POWERPC NATIVE ! EXISTING USERS UPGRADE FREE! 


Onyx Technology 7811 27th Ave Bradenton, FL 34209 

Tel: 941.795.7801 Fax: 941.795.5901 

$99 Web: http://www.std.com/onyxtech/ 
AOL: OnyxTech AppleLink: D2238 CIS: 70550,1377 
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component B will not differ for the Pascal and Modula-: 
implementations. Next we branch off a variant of component 4 
for a Sun workstation, where (conversely) component 4A is 
believed identical for Macintosh and Sun (instant 1). 

At instant 1, the project exists in three differen 
implementations: 
1. in Modula for Macintosh, consisting of A 2.1 and B 2.1 
2. in Pascal for Macintosh, consisting of A 1.3.1.1 and B 2.1 
3. in Modula for Sun, consisting of A 2.1 and B 1.2.1.1 


This information, however, cannot be inferred from the 
version trees in Figure 2. 












Aodula Pascal 





Figure 2. The project’s version trees at instant 1 


After development of some revisions of the different 
variants it turns out that component A must be implemented 
differently on both machines, and component B has to be 
developed in two variants according to the programming 
languages (instant 2). The resulting version trees are presented 
in Figure 3. 























B 1.2.1.2.1.1 | 











Figure 3. The project’s version tree at instant 2 


This small example shows that the chronological order of 
branching is reflected by the naming of the different variants of 
the project’s components. The shape of the trees of 
components A and B are different, although both have the same 
variant structure. As the tree structure is used for naming 
software objects, the different structures must be known to the 
user in order to enable retrieval of a certain revision of a given 
variant. A fixed revision i of the variant Sun/Modula of 
component A is referred to by 2.1, whereas the same version of 
component B is called 1.2.1.2.1.7, Moreover, at each new 
branch two digits have to be appended. If there are four 
distinctive marks within a project, the software objects in SCCS- 
like systems have revision numbers like 1.2.4.2.3.6.2.5.3.4, 
bordering on incomprehensibility. 
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rthogonal Organization 

These drawbacks can be avoided by using orthogonal 
rganization of variants and revisions. Two main characteristics 
istinguish orthogonal from intermixed version organization. 


Instead of managing versions of atomic objects only, 
orthogonal version organization also deals with variants and 
revisions of the whole software project. In fact, the 
management of versions of the whole software project is the 
basic idea of orthogonal version management. 

e Variants and revisions span the whole project and are 
considered to be orthogonal to each other. 


Using the orthogonal organization model, a software 
project consists of a set of objects which we call the object 
pool, and a set of project structure trees. The following sections 
explain these terms. 

The Object Pool. As mentioned above, our task is to 
manage a project consisting of a set of fundamental 
components. Each of these components may exist in different 
variants and revisions. We use the term object for an instance 
of a component, which is uniquely defined by a certain variant 
and a certain revision. An object could be the source text of a 
module within a software project, i.e., a particular 
implementation of a component (e.g., revision 7.3 of module 
XY belonging to variant A). We represent an object graphically 
as a small cube (Figure 4). 

The object pool of a project is the collection 

of all these different variants and revisions 

of all of the project’s components. We can 

envision the object pool as a three- 

dimensional space whose three dimensions 

Figure 4. Object are component, variant, and revision, as 
shown in Figure 5. 





components 


variants 





revisions 


Figure 5. Object pool 


The object pool can be variously “projected” [4]. For 
instance, by cutting off a vertical slice, we get a project revision 
(Figure 6), comprising all variants of all components of the 
project at a given time. Since the component group consists of 
all objects for a specific implementation of the project at a given 
time, it may constitute the basis for automatic build management. 
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KEEPING THINGS STRAIGHT, ORTHOGONALLY 








components 
components 











variants 





Figure 6. Project revision Figure 7. Component group 

Restricting a project revision to a particular variant gives a 
component group (Figure 7). 

Hierarchy 

There is also, however, a hierarchical structure connecting 
the components of a project. Representing this is the project 
structure tree, consisting of structure nodes and component 
nodes. Component nodes are the leaves of the project structure 
tree, and stand for indivisible components of the project, the 
components (e.g., a module of a program system, a chapter of 
a manual, etc.). Note that an object node does not correspond 
to a physical file. It is a logical element of the project and can 
exist in multiple versions. Structure nodes are the inner nodes 
of the project structure tree. They comprise several structure 
and/or object nodes and form a vehicle for structuring the 
project structure. The relation between parent and child in the 
structure tree can be defined as “contains”, as in a hierarchical 
file system. (Note that the project structure tree has nothing to 
do with relations among the objects; it cannot, for example, 
represent an import relationship.) 

Figure 8 shows a project structure tree together with the 
object pool. In this example, the project consists of five 
components (cl, c2, m1, m2 and m3). Figure 8 shows further 
that each horizontal slice of the object pool (called a project 
component) corresponds to one component node. 


relation 
"is implemented by" 


component nodes 
structure nodes | 


revisions 














components 





























Figure 8. Connection between 
project structure tree and object pool 


Revisions and Variants of the Project Structure. Since the 
project structure may change in the course of time, more than 
one project structure tree may exist within one project, each 
describing the structure of the project for a certain period of 
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time. Thus, a particular project structure tree does not describé 
the structure of a whole project, but rather the structure of 4 
project revision. In the extreme case, every project revision ca 
have its own structure tree. 

Figure 9 shows an object pool consisting of five projec 
revisions together with two revisions of the structure tree 
Revision 1 of the structure tree was valid for project revisions 
and 2, when the structure node m contained only component: 
m1 and m2. Starting with project revision 3, the structure node 
m additionally contains component m3. 

















project revision 


Figure 9. Revisions of the project structure tree 


Even for a given project revision, we cannot speak of the 
project structure. A certain project variant may not use some o 
the components, so that the structures of various project 
variants may differ. However, we can always imagine a total 
project structure tree, which is a project structure tree with all 
single trees overlaid. 

Figure 10 shows possible variants of the total project 
structure tree shown in Figure 8. We can see that project 
variant x does not use components cZ and c2. Project variant y 
does not use component m1, and component m3 is not used in 
project variant z. 7 





















































variant x variant y variant Z 


Figure 10. Variants of the project structure tree 


This detailed project structure tells the user exactly which 
components must be chosen when building a special variant 
of the project. (Note that there is no statement about how 
they are to be assembled; that is the responsibility of 
configuration management.) 
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For C and C++ Developers .... 


When the Text . 


Are you writinga... 
* Document Viewer? 
¢ Multimedia Product? 
¢ Report Generator? 
* Forms Package? 
* HTML Editor? 
* Email Application? 
¢ Electronic Book Technology? 
¢ Hypertext Enabled Program? 
* Program with text features? 


Then you need PAIGE. 

PAIGE™ is a library of run-time 
functions you can embed into your 
application. It will add virtually unlimited, 
programmable “rich edit” word processor and 
page layout features to any part of your program. 


PAIGE will save you hundreds of precious development 
hours. Better yet with PAIGE’s cross-platform API you can 
support the most popular desktop operating systems. 





DELTA STORAGE 

In every software version control tool, delta storage is used to 
store all the versions space-efficiently. Only one version is 
stored in full; the others are stored as delta scripts. A delta 
script (or delta) is a sequence of edit commands transforming 
one version of a document into another. One of the first 
version control tools, SCCS [7], was designed to store different 
versions of files in a UNIX environment. All source documents 
in this environment were text documents with an inherent line 
structure. The delta algorithm made use of this structure 
information and regarded lines as atomic elements of the file. 
The same holds for most of the other even more sophisticated 
version control tools like RCS [8] and DSEE [3]. 

But today’s software projects do not consist exclusively of 
text files. Programming environments may store source 
programs in the form of an intermediate language; the 
documentation may be written using a word processor which 
stores data in a special file format; different versions of drawings 
have to be stored. An extraordinarily nasty example are files on 
the MacOS which consist of a data fork and a resource fork. 

Thus, modern version control systems must make no 
assumptions about the structure of the files to be stored, but 
have to supply delta storage for arbitrary files. This means that 
they must be able to generate delta scripts between any two 
byte streams. 
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] 


In [5] we introduced an algorithm for generating deltas 
between arbitrary files. Besides its applicability to arbitrary 
files, the calculated deltas are smaller, and are calculated faster, 
than those of other algorithms [1, 2, 9]. 

We generated deltas between a large number of files and 
compared the results with those generated by SCCS (on a SUN 
SparcStation 2). For non-text files we used two versions each 
of about 30 files of different types. The total size of the 30 files 
was about 4 MB. Half of the files could not be managed by 
SCCS. Table 1 shows the results of the delta generation 
between the remaining files. 








Number of Files: 16 
Total Size: 2008 KB 
Biggest File: 855 KB 
Smallest File: 7 KB 
Total Size Total Size of Execution Time 
of Deltas Deltas:in % 
SCCS 3003 KB 149,55 % 615s 
Our Algorithm 88 KB 4,38 % 38s 














Table 1. Delta generation between text files 
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The test suite for text files consisted of two versions each 
of about 300 plain text files. The total size of the 300 files was 
about 20 MB. Table 2 summarizes the results. 








Number of Files: 307 
Total Size: 9115 KB 
Biggest File: 547 KB 
Smallest File: 31 Byte 
Total Size Total Size of Execution Time 
of Deltas Deltas in % 
SCCS 1414 KB 15.51% 256s 
Our Algorithm | 218 KB 2,39 % 158s 

















Table 2. Delta generation between non-text files 


VOODOO 


VOODOO implements the above techniques, and is usable not 
only for the organization of software development projects in a 
narrow sense (program development), but also for CAD, 
technical documentation, desktop publishing, etc. Even the 
writing of a book, for example, is a project in which multiple 
elementary building blocks (the individual chapters, 
illustrations, etc.) evolve in various revisions. 

VOODOO models the structure of the software project as 
a project tree, an extension of the structure tree. The project 
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tree represents the logical associations of the individua 
components and gives insights into their association witl 
project variants. Figure 11 shows the complete project tree o 
a small sample project. 


$C} Optimizing 

Lex a Standard 

HHO optimizing 
ae a DedaGen le Optimizing 

A Standard 


Bs Optimizing 
[) Standard 


component nodes variant nodes 


) Parser 


structure nodes version group nodes 


Figure 11. Project tree consisting of four kinds of nodes 


Let us examine the meaning of the individual kinds of nodes 


e Structure node (e.¢., ) 


Structure nodes provide the logical structure of the project. 
Each structure node can contain structure nodes an 
component nodes. 


° Component node (e.g., ) 


Component nodes represent the elementary building blocks 
of a project (e.g., a module of a program system, a chapter 
of the documentation, etc.). A component node does not 
represent a physical file, however. It represents a project 
component that can exist in multiple variants and revisions. 
Each component node is the child of a structure node and 
can contain any number of version group nodes. 


e Version group node ( [+ ) 
A version group node represents a certain version of a 
component. Each version group node is the child of a 
component node and can contain any number of variant nodes. 


e Variant node (e.g., 4 Optimizing) 
A variant node always carries the name of a project variant. 
Variant nodes identify in which project variants a certain 
version group is used. If a version group node contains a 
variant node «x, this means that this version group is used in 
the project variant x. Each variant node is the child of a 
version group node and cannot have children itself. 


In Figure 11, the example composite project (a compiler) 
consists of two parts, implementation and documentation. The 
implementation is subdivided into lexical analysis and syntax 
analysis (including code generation), of which each part again 
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onsists of two components. The further structure of the 
ocumentation is not yet defined. 

The project is being developed in two variants, one with 
ptimization and one without. The component Parser can be 
sed commonly by both variants (a version group node that 
ontains both variant nodes). The components Scanner and 
odeGen are being developed differently for each of the two 
roject variants (each variant node has its own version group 
ode). The component Switches is used only in the variant 
ptimizing (no version group node for the variant Standard). 

The connection between the project tree and the object 
ool can be illustrated by turning the version group nodes 90 
egrees, i.e., by visualizing the third dimension (see Figure 12). 
o keep the illustration clear and simple, the connections 
etween the component nodes and the object pool have been 
rawn only for the components Scanner and Parser. 


Optimizing 





Standard 








Figure 12. Connection between project tree and object pool 


Within a project managed with VOODOO, the project tree 
not only defines the logical connections between the project’s 
components, but also constitutes the basis of the user interface. 
It can be manipulated with a browser, and can be filtered by 
particular components, variants and/or revisions. 

VOODOO presents the software project in two windows. 
In Figure 13, the front window shows the project tree. The user 
is about to check in a new version of the component TCLTools. 
The other window shows the project history (see below). 

Both windows can be filtered. The variant information that 
applies to the project is not mixed with the information about 
the revisions of the individual components. The two are 
managed in a strictly orthogonal fashion. VOODOO is thus 
able to filter even the project tree according to variants of the 
project, i.e., to display only those parts of the project tree that 
are associated with a certain variant (or a set of variants). The 


filtering of the project tree is applied in two levels. 
( 
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Figure 13. Screen snapshot during a typical VOODOO session 







View John's 





Administrator's 


Hide Variant Info 
“ Use Filter 
Check All 
Check None 
“ Bug Fikes 
“Optimizing 
“ Standard 


Hide Wariant Info 
“Use Filter 








Check All 
Check None 








v &UG Fixes 
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Figure 14. Different view menus for different users 


First of all, the project tree shows nodes of only those 
variants to which the user has at least read-only privileges. The 
names of variants to which he lacks access are not displayed in 
the View menu either. The user is thus not even aware that 
these variants exist (Figure 14). 

Then, within those variants that are visible to a user, he 
can set variant filters that further restrict the view of the project. 
Figure 15 shows the unfiltered project tree for the sample 
project. The user has set the variant filter to the variant 
Standard, but has not yet activated the filter mechanism (Use 
Filter is not checked). The project tree is thus displayed 
unfiltered for both variants, Optimizing and Standard. 

By activating the filter mechanism, the nodes associated 
with the variant Optimizing are hidden. Since the component 
Switches is used only in the variant Optimizing, this component 
node is not visible in the filtered display of the project tree 
(Figure 16). 

Support for drag and drop simplifies the creation of the 
project tree as well as the task of checking in files. The user 
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drags the files he wants to store from any other application td 
the VOODOO project window. VOODOO looks up thé 
corresponding components and brings up a dialog that show 
which files will be checked in to which version group node 
Figure 17 shows an example of how files are stored to thé 
VOODOO object pool by dragging them from a Symantet 
Project Manager window. 
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Figure 17. Archiving objects using Macintosh Drag and Drop 
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Project History 

Each time a new object is archived or modifications are 
made to the project structure or variant information, VOODOO 
renerates an entry in the project history. The entry consists of 
he date and time of the modification, the affected components 
ind variants, the name of the user having made the 

odifications, and a comment. 

Figure 18 shows the history window with its two types of 
pntries. Modifications to the project structure, as well as named 
onfigurations, are displayed in bold, all other entries in normal. 

The small boxes in front of the names indicate whether 
here were changes made to the variant information (LL) 
bnd/or to the project structure (is 1_]), or whether a line 
epresents a named configuration (L_L_]). 

To provide a general view of the software project, the 
entries in the history window can also be filtered according to 
arious criteria. Setting the variant filters affects the history 
window as it does the project tree — only the entries for 
hecked variants are displayed. If one or more nodes in the 
project tree are selected, then only the history records of these 
nodes are displayed in the history window. If no node is 
elected, all entries are shown. To set the viewing time of the 
entire software project (project tree, variants, revisions, etc.), 
ou select the line in the history window with the desired 
date/time and press the Turn Back button. The entire project 

will then appear as it looked at the selected time. 










=] History of Compiler 

Show structure revisions 
bd Turn Back 
>] Show data revisions 


Time 



















Mame 





11.9.1991 10:40:10 Initial Structure 
12.9.1991 14:12:07 Instal | 
12.9.1991 14:12:58 Manua | 
12.9.1991 15:33:42 Scanner 
12.9.1991 16:10:19 CodeGen 
12.9.1991 16:12:23 Parser 
16.7.1992 10:21:12 Parser 
8 
3 


15:10:17 Manual 


31.89.1992 15:11:43 CodeGen 

1.9.1992 12:30:00 News component “Sei tches™ 
1.9.1992 12:55:57 Sui tcehes 

2.9.1992 14:26:30 Split "Scanner ™ 


2.9.1992 14:29: 22 Scanner 
-45:12 [] Version 1.7 


Figure 18. History window 


Access Control 

A problem that often arises in software projects with 
multiple programmers is that of simultaneous access of several 
programmers to a given component. Version control tools can 
help to solve this problem by providing a locking mechanism. 
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Can you spot 
the difference’? 


Plenty of people can’t. Because whether you update software with a 
full set of program disks, or a file made with UpdateMaker 2, the result 
is the same. Guaranteed. UpdateMaker updates are totally reliable. 
Its system of 32-bit checksums ensures that it updates the right file. 


And UpdateMaker is easy-to-use - simply specify the files and 
UpdateMaker builds the update. There is no scripting or use of 
ResEdit. It’s even easier for end-users — just one button to press. 


UpdateMaker 2 works with any type of Macintosh file. The updater 
files are extremely Compact. And the program options numerous. 
You can preserve or override user customisations. Save files in Binhex 
format. Update up to 20 old versions with one file. 


The real difference is the savings in time and money. Which 
explains why many of the best-known names in software 
development have been using UpdateMaker for years. 


Distribution is unrestricted and royalty-free. 


¢ 
Seat Only $225, order now by fax: (415) 964 2886 


Email: update@adi.com.au 








tos, CA 94024 Phone: (415) 964 2878 





| HS Optimizing 
Scanner 
as et} Standard 
BHO Optimizing 
np eA} Optimizing 
odeGen 
at}? Standard 
. Pa Optimizing 
EL a (_) Standard 





unlocked version group 





ik 
version group locked by the user itself 


version group locked by another user 








Figure 19. Project tree with locked nodes 


VOODOO provides its locking mechanism at the version- 
group level rather than at the component level. Since various 
version groups represent different parallel development 
branches, two version groups of a component can be worked 
on simultaneously by two team members without causing any 
problems. Version groups can be locked to prevent other team 
members from overwriting them until they are unlocked again, 
either explicitly or as a side effect of retrieving or archiving 
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We Use 
To Create Your Web Site 








At JointSolutions Marketing, small, we have the tools for your tasks. 
we have a full suite of We can even give you an address on our 
advanced authoring and produc- Web server, for hassle-free maintenance 
tion tools to design innova- and updates. 
tive destinations on the World / So call today; our teams of 
Wide Web. technology specialists are standing 
With experience working for | by to assist you. 
clients like Apple Computer and | JOINT § JointSolutions Marketing 
SCO, we can handle your every —@eyiii' © Tel: (408) 471-1500 
need—from concept, through 5 Fax: (408) 471-1511 
content, to completion. Large or varennc © http://www,jointsolutions.com 





































objects. The current status of a version group is displayed in Configuration Management, ACM SIGSOFT Software 
the project tree with corresponding icons (Figure 19). Engineering Notes 17:7 (November 1989). 

VOODOO also supports locking of files within the local 5. Reichenberger, C. “Delta Storage for Arbitrary Non-Text- 
workspace, using the Finder’s “locked” flag (instead of the Files.” Proceedings of the 3rd International Workshop on 
'ckid' resource) to lock local files. Software Configuration Management, Trondheim, Norway 

(June 12-14, 1991). ACM Press (Order Number: 594910), 
A working demo of VOODOO can be found at: 6. Reichenberger, C. “VOODOO: A Tool for Orthogonal 
ftp://<info-mac archive>/dev/voodoo-lite-17.hax Version Management.” Proceedings of the 4th International 
Workshop on Software Configuration Management, 
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- MacRegistry" 48 


~ Developer Job Opportunities | 


If you are a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 










Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 





Discreet - We are very careful to protect the confidentiality 
of a currently opined pve 


Scientific Placement i iS managed by eraduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. . 


1-800-231-5920 ° das@spi.com ¢ Fax 1- 800-757-9003 
http://www.scientific.com 


Scientific Placement, Inc. 


MT, Box 19949, Honston, TX 77224, 713-496-6100 Fax: 713-496-0373 
a MTB Box ih San Ramon, CA 94583 510- 38 nice on bdt.com 


Compuserve: a 250, 3001; 





ame ee CHICAGO AREA 
SVE Parallel Software is looking 


— — for software engineers who 
are serious about com- 
PARALLEL ponent based OPENDOC 


“Favorite environments? sortware development. We are 
interested in Macintosh or 


e ° |” 
Cliffs, CodeWarrior, & MacXperts?” | | WV. yw people with the following 


~ MacKperts] | experience: 


MACSPERT 


software desizn & engineerpig 


"C" or "C++", Pascal, OPENDOC 
Newton, NDK, or JAVA 
MacApp,Code Warrior, MacToolbox 
Oracle, Sybase, or SQL Databases 


Please write or phone: 


Mr. John D. McMahon 
Parallel Software, Inc. 
608 S. Washington, Ste. 101 
Naperville, Ilinois, 60540 
Tel (708)369-0100 
Fax: (708)355-7870 
psgmcmahon @aol.com. 
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ETRATTNER NETWORK 


COMPUTER CONSULTING SERVICES 


T he Trattner Network (TTN) has the best opportunities for Macintosh 
developers in Northern California and Nationwide. 


TN represents clients with projects in Internet, Multimedia, 
Codewarrior and OpenDoc development among others. 


N ow you can visit us our web site at www.tratnet.com 
and see what openings are available for.... 


e Software Developers e Hardware/Firmware Engineers 


e QA/QC Professionals e Project Coordinator/Managers 


e Multimedia Developers e Network Professionals 
The Trattner Network has a unique history in Mac consulting 
coupled with exposure to emerging technologies. If you are 
looking for a chance to enhance your skills and marketability, 
please send, fax, e-mail or link your resume to: 


The Trattner Network 
Attn: Emily Hoolhorst 
170 State Street, Suite 240 * Los Altos, CA 94022 
Phone: 415*°949¢9555 ext.115 ; Fax: 415°949*1026 
AppleLink: trat.net ; E-mail: emily@tratnet.com 


http://www.tratnet.com 


THE DIGITAL TALENT SOURCE 





MacTech Magazine 
is your 
recruitment vehicle 


BOVE anion| 


COMPanion, a leading developer 
and marketer of Macintosh K-12 
software, is looking for a 


Director of Development 


to lead our development team in cre- 
ating state-of-the-art Macintosh- 
based information systems. Strong 
management and technical skills 
required. Experience with C++, 
CodeWarrior, PowerPlant, Object 
Oriented databases, Multi-Threaded 


When you need to fill 
important positions at your 
company, MacTech Magazine 
is the consistent choice of 
companies across the country 
for hiring the best qualified 


Macintosh programmers and 
developers. Let MacTech 
Magazine deliver your recruit- 
ment message to an audience 
of over 27,000 qualified 
computer professionals. 


Applications, Communications (TCP/IP 
& AppleTalk), PowerPC Optimization 
and an inquiring mind a plus. 


At the foothills of the Wasatch 
Mountains, COMPanion is a growing 
company and a fun and exciting envi- 
ronment for top performers. 


Please Send Resume to: 
Bill Schjelderup, President 
COMPanion Corporation 
1831 Fort Union Blvd 
Salt Lake City, Utah 84121 
801-943-7752 fax 
801-943-7277 voice 
bill@companioncorp.com 


Call Ruth Subrin at 
805/494-9797 
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By John Kawakami 


APPLE GAME SPROCKETS FOR CUTTING-EDGE MULTIMEDIA AND 
INTERNET GAMES ON THE MACINTOSH 


Apple Game Sprockets is a new software development kit 
(SDK) to create advanced multimedia and Internet-enabled 
games for Mac OS-based computers. Using this SDK, all Mac 
OS-compatible games can feature real-time 3D graphics, 3D 
sound, Internet support, speech recognition, and input 
device/monitor control. 

Available royalty-free to all developers, Game Sprockets 
profoundly simplifies the creation of Apple Macintosh 
entertainment software. Game Sprockets includes the final release 
of QuickDraw 3D RAVE (Rendering Acceleration Virtual Engine), a 
multi-platform technology that enables game developers to 
incorporate plug-and-play 3D acceleration hardware. 

Game Sprockets encapsulates many current Mac OS 
technologies into a uniform interface. So a developer who 
wishes to add support for a feature can use a simplified game- 
oriented interface instead of the more daunting original API. 


The current Apple Game Sprockets SDK includes: 


¢ NetSprocket — Internet and multi-player gaming API 

¢ SoundSprocket — 3D sound and Sound Manager API 

e SpeechSprocket — speech recognition API 

¢ InputSprocket — digital joystick control and input device API 
¢ DrawSprocket — multiple buffering/display control API 

° QuickDraw 3D RAVE — fast, multi-platform 3D graphics API 


Apple Game Sprockets Technical Details 


NetSprocket 

NetSprocket provides standard, customizable user interface 
dialogs for configuration, log-in, and hosting a game across the 
network. A simple set of calls allows messages to be singlecast, 
multicast or broadcast to other machines within the game. A 
theoretical maximum of two billion users can simultaneously 
use NetSprocket across a broadband connection. 

NetSprocket also provides transparent access to Internet- 
oriented gameplay and multi-player gaming. This API uses 
Open Transport for TCP/IP, AppleTalk (with support for 
LocalTalk, EtherTalk or TokenTalk) and modem 
communication access. By utilizing a client/server topology, it 
is possible for gamers to use multiple protocols in a single 
session and with minimal overhead (a total of 28 bytes are 
used per player for the message header). NetSprocket also 
supports the creation of groups for broadcast of data to 
specific users across the network. 
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SoundSprocket 

SoundSprocket incorporates a standardized API fo 
accessing both traditional sound functions as well as new 30 
sound technologies developed by Apple. For 3D sound, th 
listener and each sound channel are given specific positions 
and velocity vectors in a virtual audio space. These position 
are changed during game play, along with the sounds 
themselves, to give the impression of spatiality and movement. 

The signal processing, taking advantage of the capabilitie 
of the PowerPC microprocessor, simulates Doppler Effect 
distance attenuation, environmental reverberation and spatia 
positioning. The 3D effect may be effectively presented ove 
speakers or headphones; it is also fully integrated with the 
camera position used in QuickDraw 3D, which enables sound 
to “follow” the player in 3D space. 


InputSprocket 

InputSprocket provides a compact API through which 
games can communicate with drivers for analog or digital 
joysticks and other game-oriented input devices. It also 
provides user interface elements that allow player override o 
the default control options through specified dialog boxes. 
Mouse and keyboard support are also enabled, as are multiple 
input device support. 


DrawSprocket 

DrawSprocket allows developers to easily utilize multiple 
(double or triple) buffering on the Macintosh for smooth display 
of graphic images. Multiple buffering is achieved by 
DrawSprocket using the best option available on the user’s 
system — true double buffering in hardware, page-flipping, 
efficient memory copies, or through the traditional CopyBits 
function call. The game does not need to be aware of the 
hardware specifics. 

DrawSprocket also enables configuration of display 
resolution or color depth without leaving the game environment 
(no need to access the sound and displays control panel) and 
screen sizing/blanking. A sprite engine, available through 
QuickTime, may also be used in tandem with DrawSprocket. 


SpeechSprocket 

Based on Apple’s PlainTalk technology, this API allows 
developers to easily include high-quality speech recognition in 
their game titles. 
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ickDraw 3D RAVE 

Recently announced as the first component of Apple Game 
prockets, RAVE enables developers to transparently access 3D 
raphics accelerators for maximum speed and throughput while 
Iso providing exceptional 3D rendering speed in software. RAVE 
ets game developers leverage their existing rendering 
echnologies — a key issue for vendors seeking to differentiate their 
ontent. RAVE is shipping now for Power Macintosh and Microsoft 
indows 95, with a Windows NT version due in April 1996. 










ontact Information 

Game developers interested in learning more about Apple 
Game Sprockets should email Mark Gavini, Macintosh Games 
Evangelist, at gavini@apple.com. Product marketing 
information may be obtained from Ben Calica, Senior Product 
Manager, at calica@apple.com. For more information about 
home entertainment solutions, contact Yves Martin, Manager for 
Home Entertainment Solutions, at martin.y@applelink. 
apple.com. 
Sprocket is a trademark of MacTech Magazine. 


http://dev.info.apple.com/games/ 


MoreFILes 1.4.2 

MoreFiles is a collection of high-level routines written in 
response to File Manager questions developers have posed to 
Apple Developer Technical Support and have asked on various 
online services and the Usenet. The routines have been tested 
(but not stress-tested), documented, code-reviewed, and have 
been used in many commercial products. The latest version, 
1.4.2, was released on March 25, 1996. 


<Info-Mac site>/dev/src/more-files- 142.hqx 


FREE BBEpiT T-SHIRTS TO WEB AUTHORS 

Bare Bones Software is running a promotion to give free 
T-shirts to HTML authors, webmasters, and professional Web 
developers who include the trademarked “Built With BBEdit” 
graphic in their Web pages or sites, including sites developed 
for clients under contract. See their Web site for the graphics 
and more information. 

Bare Bones Software, Inc., P.O. Box 1048, Bedford, MA 
01730-1048. Tel: (508) 651-3561; Fax: (508) 651-7584; Email: 
bbsw@barebones.com 


http://www.barebones.com/ 
TEsTTRACK 
TestTrack, a software quality productivity tool for Macintosh 


developers, eliminates the need to build custom database 
solutions for tracking bugs and enhancement requests, while 
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adding valuable communication and work-flow features. 

TestTrack is ideal for any software developer who needs to 
track bugs, change requests and enhancement requests. 
Software development teams benefit additionally from 
TestTrack’s notification and routing features, which guarantee 
communication between team members and ensure efficient 
work flow. TestTrack also helps software consultants stand out 
in the crowded development market — providing solid QA 
practices is appealing to any prospective client. 

In addition to tracking bugs and enhancement requests, 
TestTrack tracks test configurations and team members. By 
tracking test configurations, you can match problem patterns 
related to specific computer software and hardware setups. By 
tracking team members, you can monitor work loads at a 
glance, and determine which team members are overloaded 
and re-assign some of their work to other members. 

TestTrack is now shipping and is priced at US$149, but for 
a limited time, TestTrack carries an introductory price of only 
US$99. A one-year subscription, with at least three mailings 
per year, is US$249. Volume pricing and site licenses are 
available. TestTrack is available direct from Seapine Software 


by calling (513) 683-6450. 


http://www.seapine.com/ 


SUPERCDEFs 
SuperCDEFs is a collection of professionally designed and 
crafted controls that give an application the finishing touch 
needed for a polished “3D look.” 

These attractive controls can be used in conjunction with 
Apple’s standard controls, or to replace them in an application. 
Four types of control are included: buttons, tabs, sliders and 
thermometer. 

All SuperCDEFs are shipped in 680x0 format, Power 
Macintosh native format, and Fat/Safe Binary format combining 
both 680x0 and Power Macintosh native code in one resource. 
They run on all Macintosh models (512KE or later) and all 
system versions (System 5 or later). A one-time US$89 license 
covers unlimited royalty-free distribution of applications 
created using SuperCDEFs. 

The SuperCDEFs package is also included as part of the 
Tools Plus (non-Academic) Application Development Kit. 
[Don’t buy it twice —jk | 

Water’s Edge Software, 2441 Lakeshore Road West, Box 
70022, Oakville, Ontario, Canada, LOL 6M9. Tel: (416) 219- 
5628; Fax: (905) 847-1638; Email: WaterEdgSW@aol.com 


http://www. interlog.com/~wateredg/ 


VRML Conclusion: MOVING WORLDS 
The Moving Worlds proposal has been picked to be the next 
VRML standard, and the binary file format will be based on the 
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Apple 3DMF format. The first VRML was largely an academic 
project promoted by individuals and visionaries. The 
competition to develop VRML 2.0, in contrast, was dominated 
by computer industry giants like Silicon Graphics, Netscape, 
Apple, and Microsoft. 


http://www.vrml.org/ 


MOTOROLA PORTS THEIR OPTIMIZING COMPILERS 
TO ALL PLATFORMS 

Version 3.0 of the Motorola C/C++ Software Development Kit 
(SDK) for Mac OS offers a complete set of development tools 
for Apple’s Macintosh Programmers’ Workshop (MPW) 
environment, including the Kuck & Associates Preprocessor 
(KAP). This new version of the Motorola SDK includes “plug- 
in” versions of the C/C++ compilers that can be directly used 
by licensees of the Metrowerks CodeWarrior and Symantec 
Project Manager development environments. The Motorola 
SDK also includes versions of the highly optimized “libmoto” 
libraries that are compatible with the Apple, Metrowerks and 
Symantec environments. 

The Motorola SDK 3.0 will bring the highest performance 
available to Mac OS developers, enhancing applications such as 
interactive entertainment and computer games. Tests have 
shown that code generated by the Motorola compiler is up to 
18% to 29% faster than code generated by other industry- 
standard compilers for a broad series of industry-standard 
benchmarks, including Nullstone, Dhrystone, Whetstone, 
Linpack and the BYTE benchmarks. 

As the first SDK to provide support for Apple’s MPW, 
Metrowerks’ CodeWarrior and Symantec’s Project Manager 
development environments, the C and C++ compilers enable 
developers to optimize code simultaneously for members of 
the PowerPC family of microprocessors, including PowerPC 
601, PowerPC 603, PowerPC 604 and PowerPC 620, while 
still maintaining code compatibility across all PowerPC 
family members. 

The Motorola C/C++ SDKs are available for an initial list 
price of US$299 by calling (800) 347-8384 in the U.S. or 
(512) 891-2999 internationally. This package includes MPW 
and a complete set of documentation. 

A “plug-in” kit consisting of only the Motorola C/C++ 
compilers, assemblers and “libmoto” libraries for the 
CodeWarrior and Symantec Project Manager environments is 
also available for an initial list price of US$99. Both packages 
include one year of maintenance and product upgrades. 


Roaster Release 1 has a revamped integrated development 
environment (DE) and comprehensive feature set. Roaster 
DR1, released on January 5, 1996, included a hierarchical 
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project window, powerful source code editor, interpreter, Jav 
compiler, debugger, and speedy runtime engine. Roaste 
Release 1 includes the following new additions: 


¢ Full support of Sun Microsystems’ JDK T1.0, including 
networking classes 

e Fully integrated class tree and class browser windows 

e Support for 68K machines 

e Comprehensive AppleScript support 

e HTML editing functionality 

¢ Context-sensitive online help 


This release of Roaster also includes prerelease versions of 
the following: 


e Visual tools for quick and easy interface development 
e Source-level visual debugger 


Roaster is the first of a series of Java development tools 
that Natural Intelligence is planning for the coming year. At 
WWDC, Natural Intelligence will be making further 
announcements regarding the Roaster Product Line. 

Upgrades to Roaster will be sent to registered owners. 

Roaster is priced at $299. Those who do not own Roaster 
can purchase the commercial release through Natural 
Intelligence at (800) 739-1616, or through Developer Depot, 
Apple’s Macintosh Developer’s catalog, MacMall, or Mac 
Connection Catalogs. 


http://www.natural.com/ 





To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 
productinfo@xplain.com 





Visit MacTech Magazine’s Web site! 


http://www.mactech.com 
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LOCATORS 





By Jim Straus, URLs@mactech.com 





Spare your fingers and find the full list online at: 
http://www.mactech.com/URLs.html 


Welcome to the latest update on Macintosh/Internet 
information. This month we have an eclectic collection of 
information available on the Internet including more Java beans, 
and the latest from Dave Winer. 





nternet Related 





MacBird 
see also 


ACIUS(4D) 
Micro Fox Software 


Internet 
I am sure you have heard about the battle of the Internet 
browsers, but just to make sure that you know where to find 


each, here are the URLs. 

Netscape Navigator 2.0 _http://cgi.netscape.com/cgi-bin/123.cgi 

Microsoft Internet Explorer 
http://www.microsoft.com/ie/platform/macie.htm 


Speaking of Java, we have another site of Macintosh- 
specific Java information, by Rusty Harold, who also writes the 
Well Connected Mac. Between the two, Rusty must be keeping 


quite busy. Check it out if you are interested in Java. 
Cafe Au Lait (MacJava) _http://sunsite.unc.edu/javafaq/ 


Dave Winer has yet another spin-off of his Frontier 
technology. He has created a graphical front end to Frontier 
that can be invoked from within Web pages. It is sort of like 
HyperCard for Web pages. He is currently trying to port it to 
other environments, but if you have a Macintosh (which I bet 


you do), you can try it out first. 
MacBird http://www. hotwired.com/userland/macbird/ 
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Macintosh 

Apple is in the process of putting Inside Macintosh on the 
Web. Not just references, but the complete books, including 
illustrations, tables, and sample code! They have QuickDraw- 
3D and Files available as I write this. Is this a sign of what is to 


come in the publishing business? Stay tuned to find out. 
Inside Mac http://dev.info.apple.com/insidemac.htm 


For those of us interested in development and debugging, 
Seapine has created a page of testing and quality-control tools 


(debuggers, testing tools, source code control, testing services). 
Seapine Software (MacQC) http://www.seapine.com/qclinks.html 


Here we have someone doing Apple’s job. Matthew McRae 
has taken it upon himself to be an unofficial evangelist for the 
Macintosh. He is maintaining an archive of the EvangeList 
mailing list, soliciting suggestions from people about how to 
make the Macintosh better, keeping a page of links to other 
information, and in general doing what an Evangelist does. 


Maybe Apple will hire him when he graduates. 
MacEvangelist http://www.seas.upenn.edu/~mcrae/macevan/ 


Neat non-Macintosh site of the Month 

Well, it's not non-Macintosh, but you can certainly waste a 
lot of time! Time-Warner has built a graphical network chat 
system that runs on the Internet, as well as AppleTalk networks. 
It is really quite neat! If you go to the Web site below, you can 
download the software. Besides providing a client, you can 
also download a server that will let you create “rooms.” The 
Palace is a virtual building that is distributed across publicly 
accessible servers. To access all of the features of the client, 
you need to register the software, but it isn’t very expensive, 
and you can then give yourself your own name (instead of 
Guest) and create your own face pictures. If you really get into 
it, you can write programs in iptScrae (pig latin anyone?) and 
cause all sorts of magical things to happen. There are many 


cool ideas here, and it is lots of fun. 
The Palace http://www.thepalace.com/ 


Well, that is it for this month. As always, if you find 
something interesting, or have updates, send them to 
URLs@MacTech.com. 

Thanks this month to Jesse Carneiro, Rusty Harold, Maurice 
Inzirillo, Holli Kearns, Matthew McRae, Brent Simmons, and 
many others for their contributions of suggestions and pointers 
to new and old sites. 
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OPENDOC FRAMES AND FACETS 


A major difficulty confronting every first time 
OpenDoc programmer is the difference between Frames and 
Facets. Both seem to refer to the “portion of a window” 
concept expressed in PowerPlant as a “pane” and in other 
frameworks as a “view”. In common frameworks, the pane 
hierarchy is both an embedding hierarchy and a visual 
hierarchy. In OpenDoc, the embedding hierarchy (frame) is 
separated from the visual hierarchy (facet) to allow for more 
flexibility in imaging. 
In order to understand the separate roles for frame and 
facets, | have found it useful to create my own subtitles: 


Frame — a contract for embedding 
Facet — a region of a GrafPort 


Think of ODFrame, first and foremost, as a relationship 
between two parts; a frame is a contract between a container 
and its embedded content. An embedded part is connected to 
its containing document only through its frames — if all the 
frames are closed, the part is no longer in the document. The 
embedding hierarchy alternates between parts and frames: parts 
have embedded frames, which have parts, which have 
embedded frames, and so on. 

The ODFrame contract covers three primary areas: the 
shape of the embedded content, the view type (icon, thumbnail, 
or normal imaging), and the presentation format (particular to 
the kind of content, e.g. a chart, table, or graph). The container 
and embedded content mutually agree on these areas during a 
process called “frame negotiation”. 

Either party can initiate frame negotiation. For example, a 
browser might want to show both an icon and a normal image 
for a particular embedded part. This container would create 
two embedding contracts, each with different shapes, view 
types, and presentations. On the other hand, a game controller 
might want to negotiate an irregular pod-shaped frame for its 
alien-like control panels. It would have to ask its containing 
part to approve this shape. 

Frames, however, are an abstract contract. They are not 
portions of a window. In particular, frames have no GrafPort, 
no offset location, and no front-to-back ordering. To fulfill the 
abstraction, the container must make one or more facets for 
each frame that it wants to display. By making a facet, the 
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container makes the frame visible and allows the user tc 
interact with it. 
Think of a facet as a region of a GrafPort. A facet has a 
coordinate transformation to locate itself in the GrafPort, and a 
clip region to make sure it does not exceed its bounds. <A facet 
has a z-ordering, and can be highlighted or selected. Facets 
(and not frames) form the visual hierarchy. Importantly, facets 
cannot be negotiated. The container has sole control over 
assigning facets to its embedded frames, though it must respect 
the negotiated frame shape when it does so. 

In most cases, the container creates only one facet per 
frame. Multiple facets occur in situations where a container has 
a split-screen view, and the same frame is imaged in multiple 
locations, with different clip regions. Another common use of 
facets is in page layout, where a frame might be split between 
the bottom of one page and the top of the succeeding page. To 
create the gap between pages, the container assigns upper and 
lower facets to the frame. But note that if a frame has multiple 
facets, they must all be in the same GrafPort. If you want to 
image the same content in two different windows, you must 
create a second frame (contract) for the second window. 

If you think about it, the distinction between frames and 
facets makes logical sense. Consider a database container that 
stores thousands of embedded parts. After a search, the 
database displays 3 or 4 of those embedded parts. In this 
scenario, only the search results need facets (regions of a 
GrafPort) for display. But the database needs frames (the 
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ontract governing embedding) for all of the thousands of parts. 
t would likely want to remember the shape, view type, and 
resentation of each of these parts, so that when it needs to 
isplay them, it can show them just as they appeared the last 
ime. Frames represent the persistent contract between the 
atabase and its embedded items. Facets represent the visual 
egions of the currently displayed parts. 

For programmers with experience in other frameworks, the 
ost important thing to remember is that a frame is not a 
ortion of a window. It is simply a negotiated contract 
overning the shape, view, and presentation for an embedded 
ontent. This shape, view, and presentation becomes visible 
nly when the container fulfills this contract by creating a facet 
or the part, thus specifying its GrafPort, origin, and clip shape. 


Jeremy Roschelle 


YANKING INGENUITY 
hese days, installing RAM in some of the new Power 
Macintosh computers is not as easy as it was with the 
Macintosh II series. So, here’s a tip for you Power Macintosh 
8500 owners... 

If you need to get access to your motherboard to install 
RAM, VRAM, or more Cache RAM, you're going to have to first 
remove the deep-seated processor card before the motherboard 
can be removed from the chassis. This card is really difficult to 
remove because it is in there tight, and there just isn’t a lot of 
finger space to allow you to get a good grip on the card. After 
a couple roughed-up knuckles and sore finger tips, I found the 
following sane approach to solving this headache: 

Take two small nylon cable ties (any color will do) and 
loosely loop them through the sturdy holes in the upper corners 
of the processor card. Then, you can easily insert your fingers 
through the two cable tie loops and apply enough equal 
pressure to carefully remove the processor card. 

The good news is you can leave those cable ties in there in 
case you need future access to the motherboard (unless of 
course you have some other need for the holes). 

Disclaimer: this tip has been thoroughly tested on several 
Power Macintosh 8500 computers and is bug-free. It is possible 
that some of the other models could also benefit from this tip. 


™~- 





Mark D. Gerl 


[On a related note — the processor daughter card in 
PowerMac 9500 has a tendency to wander out of its socket if 
you move the machine around. This is fatal to the processor 
card. The repair person who fixed mine suggests opening the 
machine and re-seating the card if you move it to a different 
office, etc. — sgs | 


June 1996 @ MACTECHMAGAZINE 


Authorized Apple Duplicator 
For 11 Years! 


From idea to delivery...all handled with top quality service and speed. 


Complete Software =e 
Duplication Service 


[rtemational Datawares is built around things we make: we duplicate soft- 
ware, assemble it, package it. We can handle any part of the job that you want. Or 
we can handle it all. IDI is equipped to duplicate from Apple to Xerox, for small or 
large orders, with fast turnaround time. We back up every disk we duplicate. Each 
is machine-verified bit-by-bit; many are checked by hand. IDI uses top-quality, 
certified media. What's more, we work with you to provide disk serialization and 
copy protection schemes to help track sales, register updates, and stop piracy. 


We can pack all the pieces that go into your product—disks, manuals, reference 
cards, and more—and put it all into a shrink-wrapped box. You can provide us 
with your own packing materials, or use IDI’s. Our proven packing materials are 
sturdy, inexpensive, and will fit in standard packing boxes. 


IDI now offers CD-ROM duplication ser- ; 
vices. Each job is customized so please call International Datawares, Inc. 


us. We'd be happy to fax you the details for 800-222-6032 


your special project. 


2278 Trade Zone Blvd ¢ San Jose ¢ CA ® 95131 
(408)262-6660 — fax:(408)262-8906 _ idikds@aol.com 





IMMEDIATE DRAG MANAGER FEEDBACK 
The Drag Manager allows a feeback region to be dragged by 
the mouse. This region is created and passed into the 
TrackDrag trap: 


TrackDrag ( 
DragReference theDragRef, 
const EventRecord* theEvent, 
RgenHandle theRegion) ; 


The Drag Manager doesn’t actually draw this region until 
the mouse has actually moved. Sometimes it is helpful if this 
region is drawn immediately. What to do? 

Just futz with the where field of theEvent by a few 
pixels. 

theEvent->where.h t= 3; 


theEvent->where.v t= 3; 
err = TrackDrag(theDragRef, theEvent, theRegion) ; 


// the 3 comes from DnD HIG, p. 7 


..and a comment on the XOR Anti-Tip 
One of the problems with the XOR swap (MacTech 
Magazine 11.10 [October 1995] 96) is that it doesn’t work if the 
source and destination are the same variables, as could happen 
with complicated, deeply nested macros. 
Chris Sears 
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...and all day too. In fact, we’re open 24 hours a day, 
365 days a year! 

Which means that whenever you get a craving 
for the latest in developer tools, we're just a couple 
of keystrokes away. 

You can browse for hours (we don’t mind), 
pick up the items you want, and conveniently pay 
with your major credit card at our virtual check- 
out. Then, kick back and wait for your goodies to 
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arrive - all without ever leaving your house! 

Best of all you'll shop confidently, because at 
Developer Depot, you’re guaranteed complete 
satisfaction and the best prices for 30 days after 
your purchase. 

Talk about a safety net! 

That’s right, and speaking of nets, get connect- 
ed and come check out the vastest on-line selection 
of developer products... any day, any time! 





http://www.devdepot.com 


Dear Developer, 


Since March, 1985, MacTech” Magazine (then MacTutor) has been the 
place for you to find Macintosh Development products — the majors as 
well as those harder to find. Back then ... and today, our focus has 
always been for the Macintosh developer community to grow and prosper. 


But you deserve more than simple listings - and you’ve asked to make 
it easier to find and order products while maintaining our renowned cus- 


tomer service and pricing. We've been listening ... 


We are therefore proud to announce Developer Depot" — a new 
mail order concept and entity dedicated to you, the Mac OS Developer. 


What makes Developer Depot so good? 
e World renowned customer service 


e 24-hour and full accessibility via our continually updated web site 


(http://www.devdepot.com) 
e Satisfaction and best price guaranteed 
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e A new, easy to remember toll free phone number (800-MACDEV-1) 


e Great selection (hundreds of products) 


e Convenience: you can order in many ways (web site, e-mail, fax, phone) 
e A new full color, organized, and expanded catalog — updated monthly 


Additionally, we are a Macintosh house using an all Macintosh 
system. Our knowledgeable staff can answer your questions about 
products — and if they can’t, they'll find the answers for you. 





While Developer Depot is completely separate from MacTech Magazine, 


Developer Depot is the primary source for all MacTech products. 


Let us know what you think — we’re here to serve you. 
Developer Depot: The products you need with the service and prices 


you deserve. 


Neil Ticktin 
Chief Executive Officer 


Developer Depot 30 day Money Back, Price and 

Satisfaction Guarantee 

Developer Depot products are sold with a 30 Day money back guar- 
antee on user satisfaction, lower prices and against defects. If, for any 
reason, you are not satisfied or find the same product at a lower price 
within 30 days, please call Customer Service at 800-MACDEV-1 and 
request a Return Merchandise Authorization (RMA) number to get a 
full refund or the difference in price (where applicable). You must 
return undamaged product at your expense, including all its original 
packaging, documentation and the blank warranty card if applicable. 
Developer Depot will replace defective product upon receipt of the 


Stuff our lawyer made us write. 





EAP 


Andrea J. Sniderman 
Chief Operating Officer 





defective merchandise. Please remember to back up your data before 
installation of any new hardware, software, or peripherals; we cannot 
be responsible for any lost data. Policies, item availability, and prices 
are subject to change without notice. The price in effect when we 
receive your order will be the price that you are charged. We are not 
responsible for any typographical errors in this or any other catalog, 
nor for any misstatements from any vendor. Purchase orders are also 
accepted but must be in writing, signed, come with a contact person 
and a telephone number, and mailed to P.O. Box 5200, Westlake 
Village, CA 91359-5200. Faxed copies and purchase order numbers 
alone are not acceptable. 


x 
y) 


Developer Depot makes no other warranties. All other warranties, either expressed or implied, including the implied warranty of merchantability and fitness for a particular purpose 
are disclaimed. Developer Depot shall not be liable for any direct, special, incidental or consequential damages including lost profits, from any delay in delivery, or for any person- 
al injury arising from the use of any product sold through Developer Depot. The limit of direct damages, if any, shall not exceed the purchase price of the product. 


© 1996 Xplain gl Sepa All rights reserved. Any unauthorized duplication is in violation of federal laws. Developer Depot is a registered trademark of Xplain Corporation. All 
product names in this catalog are the trademarks of their respective holders. 











For Macintosh 
Programmers & Developers 









MacTech Magazine 


Subscriptions: US magazine: $47 for 12 issues 
Canadian: $59 for 12 issues 

International: $97 for 12 issues 
Back Issues: $5 each (subject to availability) 





MacTech CD-ROM Volumes 1-11 NEW! 


e 1420+ articles, from all 127 issues of MacTech Magazine (1984-1995). 

Improved hypertext, and a new THINK Reference Viewer — for lightning quick access! 
New hyperlinks between articles allow you to jump to other relevant articles. 

100+ MB of source code — use them in your own applications, with no royalties! 
Full version of THINK Reference™ 2.0. The original online guide to Inside Macintosh, Vols. I-VI. 
SOMB of FrameWorks/SFA archives. The most complete set of FrameWorks archives known. 
Sprocket™! MacTech’s Tiny Framework that compiles quickly and supports System 7.5 features. 
The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas. 

Popular tools that Macintosh programmers use to increase their productivity and much more! 


List $39.00 Our Price $49.00 — Upgrades: Our Price $39.00 





MacTech Mouse Pad 


Slide on this! With an extra-large surface (11” by 10”) and a deluxe sleek plastic 
coating, you'll be zooming across your screen in no time at all. 
speed limit not enforced! 


Our Price $8.95 Order Toll-free 
B00-MACDEV:1 


(800-622-3381 








PAGLUSIVES! 





FrameWorks Magazine 
$8 per back-issue, subject to availability. 


FrameWorks Source Code Disk 
$10 per back issue, subject to availability. 





MADACON ’93 CD-ROM 

The highlights of MADACON ’93, including Mike Potel on Pink, Best of MacTutor 

Bedrock, MacApp, OODLs, and more. Slides, articles, demos, The Best of MacTutor Collection, Vols.3-5. 
audio, and QuickTime. List $95.00 Our Price $9.95 per set. List $69.00 Our Price $9.95 per set. 









Check out hundreds of more products on 
our Web site: http://www.devdepot.com 
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Starter Kit For Macintosh 


i CodeWarrior 9 Gold by Metrowerks 


* Build applications for the Mac OS, Windows 

95, Windows NT, Magic Cap, & the new Be OS. 

e Includes C, C++ and Object Pascal compilers, source-level 
debuggers, object-oriented frameworks (PowerPlant, MacApp, 
MFC), Apple’s MPW, complete online documentation and source 
code examples for all languages and platforms. 

e The IDE software has been localized in eight languages plus 

English. CodeWarrior is sold on an annual subscription basis and 






see eELATED CATEGORY 


e Includes a 1 year MacTech subscription. elt. 


vedasionielees 8 Bronze Our Price Macintosh 


ild applications for the Mac OS on 68K machines. 
Sude: C, C++ and Object Pascal compilers, source-level debuggers, object 
iented frameworks (PowerPlant, MacApp), Apple's MPW, complete online 
bcumentation and source code examples for all languages and platforms. 
e IDE software has been localized in eight languages plus English. 
bid on an annual subscription basis and has three major releases each year. 
cludes a 6 month MacTech subscription. 








Metrowerks CodeWarrior 
Programming 


ur Price 
<a Wor, 
* 2 
. % 
C3) 


o 
Feel Good ~ 
about your 
b purchase! a 
° 


‘CodeWarrior Mouse Pads 
Fight your way through the night with these cool-looking pads! 
e Arnold: Our Price 
e Gears (not pictured): Our Price 


°Y returt °° 





pdeWarrior Wear (XL only) 
live it, you breath it... you might as well wear it! 


lack CodeWarrior Sweatshirt: Our Price 

Blood, Sweat & Code” black long-sleeve shirt: Our Price 
ross Platform white shirt (not pictured): Our Price 
awaii Five-O shirt (not pictured): Our Price : 
\rnold at work T-shirt (not pictured): Our Price bau 
at (black or white): Our Price 





inter Hat (not pictured): Our Price 


Bra 





alitalkAgents® by Quasar Knowledge Systems  SOUICe code management provides an almost infinite variety of 


eatures a new generation of the Smalltalk language, QKS ways to cross-reference, access, view, and manipulate your 
alitalk”. © Productivity is no longer measured in ines"oF code and objects. ¢ Includes an Application Delivery Toolkit 
He, but in project completion time. © Allows “live” direct (ADT) that allows you to create royalty-free, stand-alone, dou- 
nipulation of your objects. © Provides a dynamic, interactive ble-clickable applications in Jusia fhatter of minutes. * Any 


1 iterative development process. @ Provides easy and full component built in AO/S will function as an OpenDoc component 
Lass to the features of the Mac OS” and Mac Toolbox or container and components from non-AO/S sources can be 


ink your non-Smalltalk code resources using our External patie integrated into the;\O/> systen SEE RELATED ee 
de Linking Toolkit” (ECLT). © A sophisticated database for Our Price spt internet Relate 


DEPOT 


eb site: htto://www.devdepot.com © E-mail: orders@devdepot.com 






‘i 









Can’t find what you’re looking for? 
Check our Web site: http://www.devdepot.com 
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SFE RELATED PRODUCTS: SEE RELATED PRODUCTS: SEE RELATED PRODUCTS: — SEE RELATED PRODUCTS: 


de Manager | Inside Power Plant Inside CodeWarrior 8 C++ Programming Discover Programming 
| -_ with CodeWarrior 


has three major releases each year. SEE RELATED PRODUCTS: 


SEE RELATED PRODUCTS: 
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SEE RELATED PRODUCIS: 


Programming in 
Symantec C++ 


SEE RELATED PRODUCTS: SEE RELATED PRODUCTS: 
Symantec C++ Learn C++ on the 


Symantec C++ 8.4 Programming | — 


e Native for Power Macintosh. 

e Develop full-featured Power Macintosh applications quick 
e Environment includes: a true native Power Mac implementa 
compilers for fast Power Mac executable code, Visual Architet 


SEE RELATED PRODUC 


Mastering theTHIN 
Class Library 


































powerful, easy-to-use source code debugger. 
e Also includes: The industry-standard THINK Class Library! 
e Next two updates free when you send in your registration card and mor 


List $499.00 Our Price $349.00 
Symantec C++ for 68k 


e The standard in development languages. ¢ Powerful combination of fully integrated visual tools and the latest in C and C++ 6 cor 
technology. © Provides an object-oriented approach to application development. ¢ Write code that is extensible, reliable“arid” 
maintainable. Includes: Integrated Environment with full source-code debugging, Incremental Linker which eliminates long link t 
THINK Class Library, AppleEvents, Visual Architect™ , THINK Inspector, Project Models, Source-Code Control with integration with 
Apple's SourceServer (included), Support for Scripting, Powerful Standard Libraries which includes I/O Streams, ANSI stahdard C 
library, and sample programs. ¢ Full source code is included — Create applications that run on 68K Macs and Power Macs (emu 
These applications can easily be migrated to native Power Mac, by trading up to Symantec C++ for Power Mac. 


List $369.00 Our Price $99.00 — 








ee 


LS Object Pascal CD-ROM by Fortner Research. 


Think Pascal Version 4.0 e Includes the world’s first Object Pascal compiler for Power Maci 






by Symantec Corporation ¢ 100% compatible with Apple’s MPW Pascal 
e Great for professionals and students ¢ Combines the best of Apple’s native development tools with inn 
e Fully integrated for rapid turnaround time — take : tive new technology developed at Language Systems 
advantage of System 7 capabilities e Compiler options specify 68K or native PowerPC code generatio 
e Supports large projects, enhanced THINK Class bray e CD includes: LS Object Pascal compiler, Universal Pascal Toolbo 
system 7 compatibility, superior code generation, and interfaces, fully loaded MPW 3.3.1, 68K and PowerPC source d 
smart linking. gers, PowerPC assembler, online documentation, Macintosh Tec 
e Includes four Macintosh disks, a user manual, and an. Notes, and a special version of AppMaker by Bowers Developme 
object-oriented programming manual. - . that generates native Pascal source code. 
Our Price $169.00 | List $399.00 Our Price $349.95 





MachTen — Power UNIX by Tenon Intersystems 


e Dynamically linked shared libraries, memory mapped file access and integrated UNIX and Macintosh development tools. 

e BSD 4.4 and conforms to the Federal Information Processing Standard 151-2 (the POSIX FIPS). 

e Pre-emptive multitasking for UNIX applications and includes a full featured high-performance TCP/IP protocol stack that 
supports multi-homing and‘ multi-casting, features not yet available even with Apple’s new Open Transport. 

e A complete UNIX software development environment with source- level debugger and C, C++, and Fortran compilers all 
generating native PPC code. ‘ 

e Also included is a high-performance X server and onic Xi 1R5 X. 


List $1,045.00 Our Price $695.00 













Personal MachTen for 68K Macs 


e MachTen UNIX for Macintosh (from Classic:on up, including PowerBooks and Duos) 
e A Mach- based eee UNL with pre- emptive multi-tasking 


¢ Built-in internet Soi include domain name service, POP mail service, internet routing, SLIP & PPP, and Web service. 
Our Price $495.00 Also Available: MachTen XWindows Our Price $350.00 


DEPOT 


1-800-622-3381 © Outside U.S. 805-494-9797 © Fax: 805-494-975 






Complete info on these products 
and hundreds more! http://www. devdepot.com 











System 


oftware development environment supporting objeckorientay programming in the BETA programming language. ¢ Uniquely 
‘orthogonal. ¢ Unifies just about every abstraction mechanism — including class, procedure, function, coroutine, 

ess and on. ° Includes: general block ‘abel strong typing, whole/part objects. The compiler: binary code generation, 
pmatic ge ascal, and assembler. « The system: persistent objects, basic 
aries with co classes, olatt a | _application frameworks on Unix, Mac and Windows NT, metaprogramming 
em. ¢ Th tosh re PW (basic set) 3.2 or later. Package containing compiler, basic libraries, 
sistent st ation. (Other packages are also available). 


ist $295. 












DOK Or PowerMac LS FORTRAN comes in two versions: one that generates 68K code (with or without FPU) and one that gen- 
tes native code for the PowerMac ¢ Source code is compatible between these two compilers © Programs originally devel- 

pd with the 68K version can boost execution speed by 4 to 6 times by running the same program on a PowerMac 

Supports all VAX intrinsic functions and data types, and virtually all VAX extensions Built-in Debugging ¢ Free Runtime 
snses e Full-featured editor, multiple window capabilities, and a powerful scripting language Highly optimized, full ANSI 
ndard, 32-bit clean, FORTRAN 77 compiler Fully compatible with virtual memory under System 7 © Supports a variety of 
d-party tools to customize any FORTRAN environment ¢ Power Tools include graphing software, subroutine libraries, and user 
arface tools @ Free technical support. | 


Dur Price $695.00 | 
LPA MacProlog 


e Comprises a Edinburgh syntax Prolog compiler system set in an attractive 
rtran 77SDK by Absoft a multi-window development environment with an integrated program editor, 
Power Macintosh includes a globally optimizing graphical call-graph facilities and an interactive source-level debugger. 

ive compiler and linker, native Fx" multi-language =e Features high-level access to the Macintosh ToolBox for using graphics, 
bugger, and Apple’s MPW development environment. dialogs, windows, icons, resources in a simple and versatile way. 


ow u 
(5 
| 


including all MIL-STD 1753 extensions 
© e Comes with the latest version. of MPW, and includes SourceBug, and 
_ SoftwareFPU : 
© Includes Absoft’s Macintosh runtime Window Environment (MRWE) 







he compiler is a full ANSI/ISO Fortran 77 imple- e Includes interfaces to C and Pascal code resources. : 
ntation, and includes all MIL-STD 1753 extensions, e Enables the production of double-clickable distributable applications. : 
y/Sun-style POINTER, and several Fortran 90 ° ¢ Optional add-ons tools include flex, Prolog++, MacDBI for Oracle and the | age: 
ancements ¢ MRWE, Absoft’s framework library is MacProlog Dialog Editor. i ai 
luded in the MIG graphics library ¢ Supports the _ Programmer Edition $745.00 Developer Edition (includes the run-time i > 
ive Macintosh PPC toolbox ¢ Includes Absoft’s Fx : | ee, 
bugger which can debug intermixed FORTRAN 77, C, generator and distribution license) $1500.00 s&s oS, | 
+, and PPC assembler @ The linker compiler, and . a 
bugger all run as native PPC tools, and produce . a 
cintosh PPC executables ; MacFortran Il V 3.3 by Absoft { past 
r Price $699.00 ~ MacFortran Il is a VAX/VMS compatible full ANSI/ISO Fortran 77 compiler oO aa | 
~~ 
ait 
x, 
ha a 
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BASIC for the Newton _/ application framework, and MIG graphics library 
e A fully interactive implementation of the ~ e MacFortran Il features improved 68040CPU support and is fully 
BASIC programming language. © , . compatible with Power Macintosh under emulation ; 
e Runs entirely on the Newton — io ost ~~” List $595.00 Our Price $549.99 { 
is required. - a aad 


e Create files, access the built-in soups, 
and the serial port for input and output. 

e Work directly on the Newton, or through 
a connected Mac/PC and keyboard. 


Our Price $99.00 


DEPOT 


Veb site: http://www. dante com °® 2 anil orders@devdepot.c com 
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From Natural Intelligence Inc. Get the most out of Sun’s new Java™ Programming Language! 


e Write, test and run Java™ applets on the Macintosh in a full-featured Mac development environment 

e Features include: project window that includes a finder-like view of packages, Macintosh native compiler, 
source code editor with powerful search features and intuitive use interface, runtime engine for quick and 
easy applet testing. 

e Requirements : PowerPC, CD-ROM. 


List $399.00 Our Price $299.00 
TGP/IP Scripting Addition” 


e Award-winning AppleScript scripting addition 

e Allows you to write scripts using MacTCP™ commands in AppleScript™. 

e Send e-mail or files through a script, check if users are logged on (via Finge 
automate FTP, Gopher, NetNews, Telnet, and LPR, verify links in HTML docu- 
ments, and quickly write many other TCP/IP client-server programs. 

¢ Works with AppleScript 1.0 or later and MacTCP 2.0.4 or later. Compatible 
Open Transport™ 1.1. 


Our Price $49.00 


SEE RELATED CATEGORY: 








OOFILE HTML Writer 


The first OODBMS framework to offer a complete solution for migrate from FoxPro and the non-O0O world. Demo’s on 
application authors. Replaceable backend database, currently CodeWarrior and AppMaker CD's. $900.00 for a once-off 





Faircom’s c-tree Plus for cross-platform royalty-free power. c-tree bundle, or $1,095.00 1year subscription. HTML and 
PowerPlant and other frameworks integrated with edit fields, character-mode report-writer $195.00. Full GUI report-writer, 
database browsers and more. AppMaker users, generate including HTML, is $495.00. Mac Platform Bundle - includes 


complete applications. User-friendly syntax makes it easier to —_all Mac frameworks, c-tree, and Report-Writer. $1,495.00 





luct move? 








Seaaas 


Get it in Developer Depot! 


The fastest, cost effective way to get product off your shelves. 
For information: * Voice: 805/494-9797 © Fax: 805/494-9798 © E-mail: marketing@devdepot.com 


DEPOT 


1-800-622-3381 © Outside U.S. 805-494-9797 © Fax: 805-494-975 














taScript 


Make your integrated AppleScript solutions database aware-today. ¢ Takes just six lines of AppleScript to make new or 
isting scripted solutions database aware, and fetch data from RDBM’s such as Oracle, Sybase, DB2, or Informix. ¢ Easy to 
arn, easy to use, and easy to remember. “Inside DataScript” contains lots of easy to follow scripts to reuse in your own solu- 

n. ¢ Very attractive licensing schemes. 


$949.00 Our Price $229.99 
4 eres FaceSpan™ v2 


Build applications quickly and easily! 


e Extensible Rapid Application Designer (RAD). 

e Combines an interactive, visual interface design environment with the object- 
oriented power of AppleScript or any OSA language. 

e Integrate the capability of scriptable programs into your custom application. 

e Display scrolling lists, popup menus, scrolling text, movies, multi-column tables, 
pictures, icons, buttons, and others. 

e Program custom objects using Pascal or C. 

e Includes a royalty-free distribution license, for unlimited runtime users, of your 
FaceSpan-based applications. Plus a FREE UPGRADE to the next version for 
registered users! 


List $199.00 Our Price $179.00 © 





ript Debugger by Late Night Software Ltd. PreFab Player by PreFab Software, Inc. 

powerful and flexible AppleScript authoring tool — get the ¢ Lets your scripts query and control otherwise non-script- 
ost from AppleScript! able applications, desk accessories and control panels. 
dvanced debugging environment offers single-step script e Adds verbs that directly manipulate the Macintosh user 
xecution with breakpoints. interface: choose from menus & pop- ‘UDS, select radio 
cript Debugger dictionary browser features a graphical view buttons, type text, determine the name of the frontmost 
f objects provided by scriptable applications. window, the state of a check box, etc. Balloon help 
ncludes Late Night Software Scripting Additions — a collection identifies non-standard dialog items. 

f more than 70 new AppleScript commands, and Scheduler,a  __-® Offers a simple, inexpensive way to distribute scripts 
tility that allows you to launch scripts at - and updates. : 
re-determined times. . e Use a standard scripting system for automated testing. 
ct $129.00 Olir Price $119.99 ; e Requires: AppleScript or Frontier 
‘i | Our Price $95.00 


riptWizard” 1.5 


e Combines the power of a professional development environment with the Mac’s ease of use. ¢ Compatible with all Apple® Open 


cripting Architecture languages, including AppleScript™. ¢ Includes delivering testing and debugging facilities to improve your produc- 


ivity. ¢ Emphasizes features that speed script development.  Single-step scripts with true statement-level stepping, watch variable val- 
es as scripts execute, jump instantly to frequently. used places in a script and find and replace specific text. 


ist $89.00 Our Price $84. 95 


™ Script er® 


¢ Powerful and easy to use, for both novices and experts. 

_ © Includes Superior vocabulary access — point-and-click assembly of commands and 
object specifications; command window for experimentation. 

e Includes Shortcuts and extended editing capabilities — extensive drag-and-drop, six- 
function find-and-replace; navigation markers; script library collection facility; many 
other timesavers for faster scripting. . 

e Interactive debugging — comprehensive variable watcher, expression evaluation, 
enhanced trace log, and real single step debugging! 


List $199.00 Our Price $179.00 















Complete info on these products 
and hundreds more! http://www.devdepot.com 


DEPOT 


Veb site: http://www.devdepot.com ® E-mail: orders@devdepot.com 
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BBEdit 3.5.2 from Bare Bones Software 


e A powerful, easy-to-learn text editor. 

e Adds new features for HTML coders, including a spelling checker and HTML tag pal 

e Accelerated for Power Macintosh; dragging supported everywhere; Internet Config 
aware; Powerlalk aware. 

e Integrated support for Symantec’s IDE, Metrowerks CodeWarrior, THINK Reference 2 
MPW ToolServer, and most other environments. 

e Many UNIX style tools, including “grep” searches, file comparisons, and sorting. Mu 
file search and replace. 

e PopUpFuncs feature lets you jump to a function from a menu. 


List $119.00 Our price $94.99 





QUED/M 3.0 by Nisus Software 


e The programmer's text editor that defined the industry standard for speed and efficiency. 

e Power PC native. 

e Features integrated support for Symantec C/C++, Metrowerks CodeWarrior 6, and MPW. 

e Supports all the major development environments on the Macintosh. 

e Dozens of powerful editing features, including unlimited undo and redo, macro language, scripting, 
text folding, ten editable/appendable clipboards, markers, displaying text as ASCII codes, dynamic 
coloring of C/C++ keywords/comments, rectangular and non-contiguous selection. 

e Includes Celestin Company’s APPRENTICE 4. 


List $149.00 Our Price $89.00 





CMaster 2.0 by Jersey Scientific 


e Installs into THINK C 5/ 6/7 and Symantec C++ for Macintosh and enhances the edi 

e Use its function popup to select a function and CMaster takes you right to it! 

e Multiple clipboards and markers, a Function Prototyper, and a GoBack Menu which ca 
take you back to previous editing contexts. 

e Almost all features bindable to the keyboard, along over a hundred keyboard-only feat 
like “Add New Automatic Variable.” Glossaries, AppleScript and ToolServer support, 
Macros, and External Tools you create too! 


Our Price $1 29.95 


SEE RELATED PRODUCTS: 


Movie Cleaner Pro by Terran Interactive Starter Kit 


e Compress QuickTime movies 
e Powerful and easy-to-use SEE RELATED PRODUC 


e Includes: drag and drop batch processing, suspend and resume, Quick Time 
high quality crop and resize, A/V fades, and much more. Official Guide 
e Automatically suggests the best settings for your application. 


e Great for both beginners and experts 
e Essential for CD-ROMs or Web sites 


Our Price $1 29.95 












SHIPPING 


(call for details) 









Check out hundreds of more products on 
our Web site: http://www.devdepot.com 


DEPOT 


1-800-622-3381 © Outside U.S. 805-494-9797 © Fax: 805-494-979 





feManager by Metrowerks SEE RELATED CATEGORY: 


burce code control system for the Macintosh. 

Ased on and compatible with Microsoft Visual SourceSafe version 4.0. 

orks with any type of binary file including graphic, database, library and executable files. 
ludes support for multi-platform projects, security features, reverse delta versioning of files, 

ymment areas for each revision, project analysis and reporting tools. 

dld on a subscription basis with two future product updates. 

cludes a 1 year MacTech subscription. 


ur Price $399.00 = 





CPU Doubler by Orchard Software 


Doubling Options 





SEE RELATED PRODUCTS: ® Performance enhancement utility for the Macintosh. © Best Performance 
a -|  e Increases the speed of your computer by 100%. © Better Performance 
() Good Performance 
e Works on both the PowerPC and 68K Macintosh. dm Cesar Partormants 
e Manages computer throughput using a proprietary 


scheduling algorithm. Special Settings 
e Ensure optimal performance and compatibility. “Enclude Files... 


Our Price $79.95 [J Exclude Background-Only | at startup 


[_] Exclude Finder to abort 





imate by Orchard Software 


ommand line interface that lets you communicate with your Macintosh using English commands to create, 

elete, rename, and move files and folders. 

start applications, format disks, restart your computer, etc. 

supplements the Finder. 

cludes a BASIC interpreter that lets you script your Macintosh without Applescript. 

cludes advanced programming constructs: repeat loops, if/then/else conditionals, subroutine calls, etc. 
plements wildcard characters, enabling you to work on groups of files. 

omes bundled with sample programs and full documentation. 

cludes a free copy of Cron Manager — chronological event management utility. 


Dur price $59.95 


File Genie Pro by Duet Development 


e File Genie Pro lets you search ALL your developer CD-ROMs at once! 
FILE a e Every Dev CD, OS SDK, CodeWarrior CD, E.T.O., and Bookmark CD you insert is cataloged 
Ni / automatically. A typical Dev CD with 10,000 files is cataloged in under 10 seconds. 

e You can also catalog opticals, SyQuests, and floppies. 

PRO e File Genie Pro quickly finds any file on any disk by searching hard disks, network servers, 
and catalogs. Open, show, print, and more. View text and graphics files without opening 
other applications. 

e When acting on an ejected disk file, File Genie Pro tells you which disk to insert, then 
continues automatically. 


Our Price $89.00 


















DEPOT 


Neb site: htto://www.devdepot.com ¢ E-mail: orders@devdepot.com 
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Guide Composer’ by stepUp Software 
¢ Create powerful Apple Guide help systems for any new or existing Macintosh application. 


¢ Great for commercial developers, shareware developers, in-house developers, and consultants. 

e Provides a WYSIWYG development environment: Guide content is developed in Guide windows. 

e Design topics, phrases, and panels in the same format as the user will use them. Features are WYSIWYG interface, | 
Topics, phrases, and hierarchical phrases, Coach marks, Fully-Integrated with Apple's Guide Maker (distributed with | 
Guide Composer), compiles scripts automatically, PICTs in Panels, Generated Guide scripts are modifiable. 

¢ Compiled files are 100% AppleGuide-compatible and royalty-free. Easy-to-use. 


Our Price $99.00 





CronManager 
by Orchard Software 


e Implements the UNIX Cron facility. 

e Open any Macintosh file on a given 
date and time. 

e Simple interface. 

e Works with any Macintosh file. 

e Cron Manager bundled with CLImate, 


Our price $26.95 


Tenon Ported 
Application CD 


e Contains hundreds of applications that 
have been pre-compiled to run on 
Personal or Professional MachTen 68k 
systems, such as Unix, Perl, and 
TCL/TK 

e Includes many internet servers such as 
Gopher, WAIS Ported Application CD 
Vol. 1 (for 68K Macs). 


Our price $49.95 


Memory Mine py Adianta 


e Monitor heaps, identify problems such as memory leaks, and stress test applications i ee 


‘Step-Up Installer Pack by stepup Software 


— RELATED CATEGORY: 


SEE RELATED PRODUCTS: SEE RELATED PR« 





SEE RELATED PR« 












| 


ScriptGen Pro by StepUp Software 


e Installer script generator which requires no programming or knowledge of Re 
¢ Supports StepUp’s InstallerPack, Stufflt compression, custom packages, 
splash screens, network installs, Rez code output, importing resources, 
and AppleEvent link w/MPW 


Our price $1 69.00 


e Package of several Installer “atoms” that let developers incorporate graphics, 
sounds, file compression and custom folder icons into installation scripts. 

¢ Compression formats supported are Compact Pro & Diamond. 

e Each atom also available separately. 

e Compression requires additional licensing. 


Our price $21 9.00 


SEE RELATED CATEGORY: 





e A collection of utilities which offer the user complete control over raw data. 

e Sort files, extract selected records, summarize frequency counts, create samp 
files, perform matching on multiple files, and reformat data to new specificatic 
all on the desktop, and even on files of a million records or more. 

e Supports AppleScript™, enabling the user to link several actions together to 
complete an entire process. 

e Recordable — users may perform a series of actions, and see them translated 
directly into AppleScript commands. 

e Supports multi-tasking and background processing. 

e Rosanne Utilities: Copy, Format, Select, Recode, Sort, Match, and Aggregate 


Our Price $595.00 






e Active status of memory in a heap is sampled on the fly: allocation in non-relocatable (Ptr), “ae “ sie — 
relocatable (Handle) and free space is shown, as are heap corruption, fragmentation, and more Bik wo 08 

e Allocate, Purge, Compact, and Zap memory lets users stress test all or part of a program rox Fences 

e Works on Macintoshes with 68020 or later and System 7.0 or later. Sree a iis hear 


List $99.00 Our Price $94.99 
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by Onyx Technology. High performance runtime stress testing for applications. = = 
sts include heap checks, purges, scrambles, handle/pointer validation, dispose/release checks, write to zero, de-reference 
brO as well as other tests like free memory invalidation and block bounds checking. 
tremely user friendly — ideal for non-programmer testers. 
So available in Japanese. 


st $99.00 Our price $94.99 


SEE RELATED CATEGORY: 





0DO0O0 
prsion control tool for the simple and clear management of projects in which files are created 


numerous versions (variants and revisions). 
lows both variant and revision control, and it manages not only variants and revisions of sin- 
le files, but of a whole software project (multi files, multi users, multi variants, access rights, 


Cc.) 
raphical user interface and is not only suitable for mere source code control but can handle all different kinds of files with amazing 


ompression rates: typical size of delta between arbitrary files 57% 
lease note special prices for multiple copies: 


ingle license $229.00. 2 pack $359.00. 5 pack $799.00. 10 pack $1 369.00: 20 pack $2399.00 


ditional pricing available on request. 





st Resort Programmers Spyer by InCider 

lition e Easy to use tool that records all actions (including mouse movement) you 
perform on a Macintosh computer and then replays them at your 
preferred speed. 

e Recorded data can be saved in files for future use. 

e Works as a background process with any Macintosh application and is 
triggered by user defined Hot Keys. 


Records every keystroke, command key 

und mouse event (in local coordinates) to a 

ile on your hard disk 

Sreat for program testing & debugging, 

and for technical support and help desks a - oo. | | 
ast Resort keystroke files and recovers e Enables the Continuous Redo” utility and is especially useful for software 
hat you typed — great for data losses testing and demonstration, 

aused by power failure, crashes, or Our price $39.00 

accidental deleting. 


Dur price $7. 4.95 


LJ Profiler by Lars Jordebo Datakonsult _ Collect, organize, compare and save profiling data from differ- 


© Supports profiling of C++ 68K and PowerPC applications ent versions of your application into a project. Scriptable and 
compiled with CodeWarrior, CFront or Symantec C++ recordable with full access to most internal data structures. 


e Based on active profiling, i.e. profiling code called at function * Optional remote profiling and tracking of segment and stack 
enter and exit, the browser application lets you follow call usage. Full source code to what you link into your application. 
Our price $295.00 


chain timings in hierarchical views or separate windows. 


pwerTap” 

\ccelerates software by tapping into multiple processors. 

“asy API — submit tasks and retrieve results! 

Full error recovery system plus scheduling algorithms for optimal assignments and fastest 


possible execution. 
Compatible with all Macintosh hardware, software and major compilers. 


Powerlap/2, 2 remotes edition List $1,200.00 Our Price $1,099.99 
Powerlap/5, 5 remotes edition List $1,900.00 Our Price $1,799.99 
Powerlap/n, unlimited edition List $2,700.00 Our Price $2,499.99 
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StoneTable 


e Replaces all functions found in list manager 

e Variable size columns/rows; different font, size, style, forecolor, 
backcolor per cell: sort, resize, move, copy, hide columns/rows: 
edit cells/titles in place; titles for columns/rows; multiple lines 
per cell; grid line pattern/color; greater than 32k data per 
table; up to 32k text per cell; support for balloon help and 


binary cell data. Versions for Think C, Think Pascal, MPW C, 
MPW Pascal, CodeWarrior 6 C. 


First compiler $1 50.00, additional compilers $50.00 


e Add rows as part of drag; popup menus or check boxes i 
cells; variable width grid lines; move/drag/resize table in 
window; clipboard operations on multiple cells. 

e Requires Stone Table. 


First compiler $50.00. additional compilers $25.00 


StoneTable and StoneTable-Extra for 


PowerPC 


e An upgrade for owners of StoneTable 
e Same functionality as 68K libraries. 





e Versions for MPW C and CodeWarrior 6 C. 
e Must have 68K libraries. 


stoneTable $1 00.00  StoneTable-Extra $25.00 


StoneTable Extra 


e Drag selected cells within table or to other tables. 





PictureCDEF 1.3 by Paradigm Software 


e Professional-level CDEF for creating custom graphical buttons (8-64 pixels) — used in products by Adobe, 
ProVue, STF Technologies and others! 

e Multi-monitor and bit-depth sensitive. 

e The button graphic (cicn, ResEdit) can be changed at runtime and even animated with a call-back routine. 

e Create distinct buttons in seven variations: MultiState, PushButton, FlexiButton, ToggleButton, ChkButton, 
PushPictButton and TogglePictButton. 

e Manual, sample code and MacApp 3.0 support included. 


Full source code: $95.00 Object code: $45.00 





SpelisWell 7 1.0.4 


e Award-winning, comprehensive, practical spelling checker that wor 
in batch mode or within applications that incorporate the Apple 
Events Word Services protocol (e.g., Eudora, WordPerfect, 
Communicate!, and Fair Witness). 

e Checks for spelling errors as well as common typos like capitalizati 
errors, spaces before punctuation, double word errors, abbreviatior 
errors, a/an before vowel/consonant, etc. 

e MacTech orders include developer kit with Writeswell Jr., a sample 
AppleEvents Word Services word-processor and its source code. 


Our price $74.95 





MacWireFrame by Amplified Intelligence 


e Create your own virtual reality application with MacWireFrame, a virtual reality 
application framework. 

e Includes a complete library of object oriented graphics routines. 

e Easy to understand application frame work, plus an example application program that 
lets you start solid modeling right away. 

e Complete with fully documented source code. 

e Guaranteed $49.99 upgrade to the soon to be released, scriptable, MacWireFrame 5.0. 


List $299.00 Our Price $75.00 © 
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B-Tree HELPER™ 2.2 


e Inexpensive database engine for Macintosh programmers in C source code. 

e Uses contiguous fixed length blocks. 

e Expands the file as necessary and contracts files when possible. 

e Inserts and deletes keys in one or more B-Trees. 

e Finds keys equal to, less than, or greater than a given value in a few hundredths of a second. 

e Finds lists of records whose keys are equal to, less than, or greater than a given value or are 
in a range of values. 


Our Price $1 50.00 





S$/3dPane/SmartPane ‘ 
ll featured 3d graphics library. 

plyhedra; Gouraud shading; stereoscopic projections; pipeline access; animation and model 
teraction support; a “triad mouse” to map 2d mouse movement to 3d; and all the regular 3D fea- 

res. 

dPane provides integration with the TCL and provides a view orientation controller. SmartPane provides TCL offscreen 
age buffering, flicker free animation, and QuickTime movie recording. SmartPane functions in 3d or 2d scenarios. 

| work with C++ compilers or ThinkC 6 and compile to PowerPC or 68K target machines. 


ur Price $1 92.00 








e The C/C++ API is identical and fully portable across all 


ne ca 
Cl supported platforms. 
Ue I nannnnnnnEenananenenneneneen e Third-party vendors supporting dtF will be able to offer a 


variety of advanced features and benefits to their customers 
royalty free. 


e Tools are included for importing, exporting, creating and 





e True relational database system for Apple Macintosh computers. 












e Provides a powerful choice for developers who want to create managing databases and users. 
database centered applications with no performance trade-offs. Supported development environments include: Symantec, 
e Features SQL, full transaction control, error recovery, single MPW, Metrowerks and more. Mac/SDK 
user, Client server architecture and multi-platform support List $695.00 Our Price $679.99 
including DOS, Windows, OS/2 and UNIX. 
FILE SEE RELATED PRODUCTS: ™ 
irst OODBMS framework to offer a | NeoAccess 
omplete solution for application e Full-featured object database engine for use in Macintosh, 
uthors. Windows, Unix and DOS based C++ applications. 
‘eplaceable backend database, currently Faircom’s c-tree ¢ Extended binary trees and binary search algorithms tuned for 
‘lus for cross-platform royalty-free power. short access times; dynamically combined, collapsed, and 


owerPlant and other frameworks integrated with edit fields, compressed indices; object caching for instant access to 

latabase browsers & more. AppMaker users, generate previously used objects. 

omplete applications. e Build fast, powerful applications in record time! 

ser-friendly syntax makes it easier to migrate from FoxPro Our price $749.00 

nd the non-OO world. 

900.00 for a once-off c-tree bundle, or $1,095.00 1-year 

subscription. 

TML and character-mode report-writer. Our Price $195.00. 
ull GUI report-writer, including HTML. Our Price $495.00. 
ac Platform Bundle - includes all Mac frameworks, c-tree, 

und Report-Writer. Our Price $1,495.00 
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AppMaker 


e Develop the user interface for a Macintosh application using the original interface builder. 
e Just point and click to design your application. YOUR ASSISTANT PROGRAMMER! 
e Creates resources and generates excellent source code. Sage 
e Supports most development environments including Metrowerks, Symantec, or MPW; | 
C, C++, or Pascal: procedural or object-oriented, using PowerPlant, TCL, or MacApp. > now 
e The generated code uses the Universal Headers to provide PowerMac compatibility. 
e Great tool for beginners to learn object-oriented and Macintosh Toolbox programming techniques. 
e Includes one-year subscription on CD. 


List $299.00 Our Price $279.99 







MacDesigner/Expert by Excel Software 


e Supports software engineering methods with the capabilities of 
MacDesigner plus multi-task design. 

e Integrated requirement database provides traceability from requirement 
Statements to design diagrams, code or test procedures. 

e Suited to design or maintenance of real-time, multi-tasking software projects. 
Expert Demo $79.00; Expert Product $1595.00; MacDesigner Demo $79.00; MacDesigner $995.00 





MacAnalyst/Expert by Excel Software 

e Supports software engineering methods with the capabilities of MacAnalyst plus state transition 
diagrams, state transition tables, decision tables and process activation tables 

e An integrated requirement database provides traceability from requirement statements to 
analysis or design diagrams, code or test procedures 

e Well suited to the analysis and design of real-time or requirements driven projects. 
Expert Demo $79.00; Expert MacAnalyst $1595.00; MacAnalyst Demo $79.00; MacAnalyst $995.00 








MacA&D py Excel Software 

e Combines the capabilities of MacAnalyst/Expert and MacDesigner/Expert into a single application. 

e Supports structured analysis and design, object-oriented analysis and design, real-time exten- 
sions, task design, data modeling, screen prototyping, code editing and browsing, reengineering, 
requirement traceability, and a global data dictionary. 
MacA&D Demo $149.00; MacA&D $2995.00 








ICONIX Power Tools = Ten modules that can be used either as stand-alones or combined to form a custom, 
integrated development environment with dictionaries and Language Sensitive Editors 


e ObjectModeler supports several object-oriented methods Processes Hierarchy Charts with FreeFlow 
with four graphical editors e ASCII Bridge enables PowerTools repository information to 
e FastTask provides real-time extensions in the form of State be merged, imported, and exported in ASCII or CDIF format 
Transition Diagrams and their equivalent matrix representation and provides an Interleaf interface. 
e DataModeler supports object-oriented analysis and includes © CoCoPro implements Boehm's Constructive Cost Model 
an Entity Relationship Attribute (ERA) Diagram Editor (CoCoMo) technique for estimating costs of software projects. 
e FreeFlow provides support for DeMarco Structured Analysis Powerlools is available both as individual modules or in 
with real-time extensions and several object-oriented methods. | PowerPack bundles of 6, 8 or 10 distinct modules of your 
e PowerPDL supports detailed algorithm design using choice: Each individual module is $1,495.00. 
pseudocode. PowerPack/6: $5,995; PowerPack/8: $6,995.00. 
e AdaFlow supports Ada-oriented design and Ada development  PowerPack/10: $7,995.00 (Full Product Line). 
e QuickChart supports Structure Chart Editing Upgrade Service: 15% of purchase price, good for one 
¢ SmartChart supports Detailed Design with automatic calendar year upgrade. 


structure Chart Generation from Program Design Language, Training and Consulting: $3,000.00 per day, plus expenses. 





ease © Outside U.S. 805-494-9797 © Fax: 805-494-9796 
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ide Macintosh°: piagrathamer'é Toolbox Assistant CD-ROM 


a 


nt electronic access to Inside Macintosh essentials. 


t quick access to reference pages for over 4,000 Toolbox calls i in your system software from 
ir development environment. 
ential information for Macintosh software developers. 


pertext links allow programmers to view related topics easily. 
ultimate electronic reference tool for Macintosh programmers. 


t $99.95 Our Price $89.95 





ide Macintosh®: Overview by Apple Computer, Inc. 


overview of Macintosh programming fundamentals and a road map to the New Inside Macintosh iérary. | 

ers various programming tools and languages, compatibility guidelines and considerations for worldwide development. 176 pages. 

at for beginners! 

t $22.95 Our Price $20.65 Inside Macintosh®: Macintosh Toolbox Essentials 

by Apple Computer, Inc. 

e Covers the heart of the Macintosh. The toolbox enables programmers to create applications 
consistent with the Macintosh “look and feel”. 

e Describes Toolbox routines and shows how to implement essential user interface elements, 

Ww windows, scroll bars, icons and dialog boxes. 880 pages. | 


List $34.95 aur Price $31.45 


ide Macintosh®: More Macintosh Toolbox by Apple Computer, Inc. 

nagers discussed include Help, List, Resource, Scrap and Sound. 

vers other Macintosh features such as how to support copy and paste, provide Balloon Help, play and record sound and 
eate control panels. 


t $34.65 Our Price $31.45 | Inside Macintosh®: Files by Apple Computer, Inc. 
e Describes the parts of the operating system that allow you to manage files. 


e Provides a reference to the File and Alias Managers, the Disk Initialization and 
Standard File Packages. 510 pgs. 


List $29.95 Our Price $26.95 


ide Macintosh®: Operating System Utilities by Apple Computer, Inc. 


escribes parts of the Macintosh Operating System that allow you to manage various low-level aspects of the operating system. 
hows how to get information about the operating system, manage operating system queues, handle dates and times, control the 
ettings of the parameter RAM, manipulate the trap dispatch table, and receive and respond to low-level system errors. 


ist $26.05 Our Price $23.45 
Inside Macintosh®: Processes by Apple Computer, Inc. 


e Describes the parts of the Macintosh operating system that allow you to control the 
execution of processes and interrupt tasks. 

e Shows how you can use the Process Manager to get information about processes 
loaded in memory. 

e A reference for the Vertical Retrace, Time, Notification, Deferred Task, and Shutdown 
Managers. 208 pages. 


List $22.95 Our Price $20.65 


side Macintosh®: Memory by Apple Computer, Inc. 
Jescribes the parts of the Macintosh operating system that allow you to manage memory. 








he Virtual Memory Manager, and memory-related utilities. 296 pages. 


ist $24.95 OurPrice $22.45 | 
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e Explains how your application can handle the commands typically found in a File menu. 


-rovides detailed strategies for allocating and releasing memory, avoiding low-memory situations, reference to the Memory Manager, 
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E- Mail Essentials by Ed Tittel & Margaret Robbins sua tannas aa es eect aoe 

e A hands-on guide to the basics of e-mail. Rea 

e Covers everything from the installation of e-mail to the mainte- 
nance and management of e-mail hubs and message servers. 

e For the casual e-mailer and the networking professional. 250 pp. 


List $24.95 Our Price 


The Computer Privacy Handbook 


e A practical guide to e-mail encryption, data protection, and 


PGP privacy software. 
e Learn the practical steps you can take to safeguard your Cyberpunk Handbook, The Real 






electronic security, | ~ Cyberpunk Fakebook 
List $24.95 Our Price by St. Jude, R.U. Sirius, and Bart Nagel. Published by 
Random House. 
; Are you or someone you know a Cyberpunk? Read this boo 
The Elements of E-Mail Style anid voulRnow 


by Brent Heslop and David Angell 


e The rules of the road in the e-mail age. 
e How to write solid, effective E- Mail and avoid common pitfalls. 
208 pages. 


List $14.95 Our Price 


List $9.95 Our Price 


The Instant Internet Guide 


e An Internet jump-start — how to access, use and 
navigate global networks, 224 pages. 


ORY: ; | 
RELATED CAIES | List $14.95 
aerate Related 
Planning and Managing Websites 


e The definitive guide to setting up and running a Web site on the Macintosh. 

e Learn everything you need to know about using WebSTAR, the best known 
HTTP server software and its shareware predecessor MacHTTP. 

e Write CGI applications for your server — in AppleScript and in c. 

e CD includes a special version of WebSTAR, plus tons of useful software. 


List $39.95 Our Price 





F RELATED CATEGORY 


CE 4 
Hooked on Java 


e Written by the Java development team at Sun. 

e An introduction to using applets, for Web administrators, designers, and 
developers. 

e Demonstrates how to use applets in your own pages. 

e Includes a concise introduction to the Java language, and a CD with tools. — 


List $29.95 Our Price 
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Complete info on these products 
and hundreds more! http://www.devdepot.com 
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5D Game Machine............. $299.00 
sD Graphics w/QD 3D.......$26.95 
Adv. Color Imaging/Mac.....$33.25 
\ ppleGuide Complete..........$35.96 
AppleScript Finder Guide....$17.95 
AppleScript Lang. Guide .....$26.95 
AppleScript Scripting Add. ..$17.05 
\pplied Mac Scripting ......... $31.45 
ROT acct seeccesnceeceunest $279.99 
B-Tree Helper .......ccecee $150.00 
BASIC for the Newton......... $99.00 


Black Art of Game Prog...... $35.99 
++ Prog. w/MacApp.......... $31.46 
++ Prog. with CW... $32.35 


DIANE vi cdccevcdesiccttoneentmtiiess $59.95 

Sap eeeweseerataneeeneed $129.95 
OdeManager....ccccceee $399.00 
odeWarrior Bronze .......... $149.00 
odeWarrior Gold ww. $399.00 


CW Mouse Pads (Arnold).....$8.95 
CW Mouse Pads (Gears).......$9.95 
CW Wear (Arnold at work)...$9.95 
CW Wear (Black Sweat)......$29.95 
CW Wear (Blood, Sweat...)..$7.95 
CW Wear (Cross Platform)..$14.95 
CW Wear (Hat)... $14.95 
CW Wear (Hawaii Five-O)....$7.95 
CW Wear (Winter Hat) ........ $14.95 


Complete AppleScript ........ $31.50 
Complete HyperCard .......... $31.50 
Computer Privacy oe. $22.45 
CPU Doubler... $79.95 __ 
CronManaget....cccececccee $26.95 


Dan Shafer ... Prograph. ....$44.95 7 


Danny Goodman’s AppleGuide 


Biter Mi acarnenanee $31.46 
Danny Goodman’s AppleScript 
Handb00k ...cscsscsscrsecssserees $35.00 
DSO wnssrorareiereasctscssenaier $229.00 
Discover Prog. for Mac........579.00 
(UE srsccsissesys ch icoeeentesreiaceden cit $679.99 
E-Mail Essentials ..............++-. $22.45 
Elements of E-Mail Style......$13.45 
Essential OpenD0.......0.0.+05 $35.95 
PU eo 0a aiveateseanmanchtans $179.00 
File Genie Pro... $89.00 
Fortran 77SDK .....scsceeee $699.00 


Fragment of Imagination... $35.96 
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__ FrameWorks Magazine 
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couenstes $8.00 


__ FrameWorks Sources Disk ..$10.00 


2 GTAPMIC GEIS, V scars rcintiisanye $44.95 
— GUI COMPOSE wicescastssicins. $99.00 
—_ Hooked on Java veces $26.95 


__ HyperCard Stack Design.....$19.95 
__ HyperTalk 2.2: The Book ...$31.50 
__ ICONIX Power Tools................ Call 
__ Inside CodeWarrior 8........... $34.95 


__ IM: 
__ IM: 


__ IM: 
__ IM: 


IM: Fi 


__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 
__ IM: 


AOCE Appl. Interfaces..$24.25 
AOCE Srvce Acc Mod...$36.40 


CDROM crsstcccrassctsanscecvineits $89.95 
DEVICES ....scsecceesesssensecseees $26.95 
FAS occ esscesssssseessseesseesne 20.95 
TANS BIS csccacoseratiactececedte $24.25 
Inierapp COMM. sadirecse: $31.45 
Mac Toolbox Essntials ..$31.45 
MeMOTY......ccsceseeeceeteeeeees $22.45 
More Mac Toolbox........$31.45 
Networking... $26.95 
Operating Sys Utils........$23.45 


OVELVIEW vocecccceeeeeeeseseees $20.65 
PowerPC Numerics .......$26.00 
PowerPC Sys Software..$22.45 
PLOCESSES vecccceccececeeeeeeeeees $20.65 
QD GX Env/Utilities .....$26.95 
QD GX Graphics.......... $24.25 


OD Gy ODES Aarau: $24.25 
: QD GX Printing........... $24.25 





QOD GX Printing Ext...... $26.95 
QOD GX Prog. Overvw..$22.45 


: QD GX Typography .....$26.95 


OGIO MC cress iaseineaorace $26.95 
: QuickTime Compnts.....$31.45 
EOC ceacraateeteseusannrese $24.25 
Tah teniaeietneninie $35.95 
i. ee a ee ee $17.95 


__ Inside PowerPlant Manual ..$34.95 
__ Inside Mac Comm Toolbx ..$22.95 
__ Instant Internet Guide.......... $13.45 
__ Last Resort Prog. Edition .....$74.95 


__ Learn C on the Mac............ $31.45 
__ Learn C++ on the Mac......... $33 26 
EY PHOTIED cassiocsarncesirpacsuonevic $295.00 
oc EPA MACE PONOS on criancececiavanindaant Call 
Be a 26.11 eee $695.00 


__LS Object Pascal CD........... $349.95 
__ Mac Bathroom Readet......... $11.70 
__ MacDesigner, MacAnalyst, or 


http://www.devdepot.com 

E-mail: orders@devdepot.com 

U.S./Canada: 800-MACDEV-1 (800-622-3381) 
Outside U.S./Canada 805-494-9797 


Fax: 805-494-9798 


~—_ MacFortrath Mevesiscsisesecnsenecin: $549.99 
__ MachTen Power Unix........$695.00 
__ MachTen XWindows.......... $350.00 
__ Mac C Prog. Primer Vol. 1 ..$24.25 
__ Mac C Prog. Primer Vol. 2 ..$24.25 
__ Mac OLE2 Prog. Ref............ $26.95 
__ Mac Pascal Prog. Primer-I...$24.25 
__ Mac Programming Secrets...$28.76 
__ Mac Programming Tech......$31.95 
__ MacsBug Ref & Debug. .....631.46 


__ MacTech CD-ROM ........c0. $49.00 __ 


__ MacTech CD (Upgrade)......$39.00 
__ MacTech Magazine (Can)....$59.00 


__ MacTech Magazine (Int’l)....$97.00  __ 


__ MacTech Magazine (US)......$47.00 
__ MacTech Mag Back Issues....$5.00 


__ MacTech Mouse Pad.............. $8.95 
__ MacTutor, Best Of... $9.95 
__ MacWireFrame........cceceee $75.00 


__ MADACON '93 CD-ROM ......9.95 
__ Mastering THINK Class Lib.$26.95 
_ MCMIONY: MINE a sacsesvscniinonessinc $94.99 
__ Metrowerks CW Prog.......... $35.95 
__ Mjolner BETA System ........$249.99 
__ More Mac Prog. Tech.......... $35.95 


__ Movie Cleaner Pro............. $129.95 
— N@OACCESS vieseccsccsseeseeeeteeen $749.00 
__ Object Oriented Design........$20.66 
__ OOFILE HTML Writer. .....0..0.... Call 


__ OpenDoc Prog. Cookbk .....$22.45 
__ OpenDoc Prog. Guide 
__ Optimizing PowerPC Code.$35.96 
__ PCI System Architecture ......$31.46 
__ Personal MacTen..........00 $495.00 
__ Picture CDEF (Obj only).....$45.00 
__ Picture CDEF (Full Srcs)......$95.00 
__ Planning & Managing 

WEDSILES ....ccsecseeteeteeee $35.96 
__ Power Mac Prog, Strtr Kit....$35.10 
__ PowerPC Sys. Architecture ..$31.46 
POOL AO ietecteaprieriwruieod Call 
_ PreFab Player... ccceceeeee $95 
__ Profit from Experience......... $22.45 
__ Prog. Toolbox Asst. CD.......$89.95 
__ Prog. with NS BASIC........... $32.35 
__ Prog. with NewtonScript .....$26.95 
__ Prog. Symantec C++/Mac....$26.95 
__ Prog. Primer Mac Vol. 1......$34.15 
__ Prog. QuickDraw ...........05 $24.25 


__ Prog. with AppleTalk.......... $26.00 
__ Q38/3dPane/SmartPane.....$192.00 


6) 61:10),\ $89.00 
__ QuickTime Official Guide...$45.00 
—— QuickTime Strtr Kit/Mac......$40.50 


__ Real World AppleGuide ......$35.95 
__ ResEdit All Night Diner .......$22.45 
__ ResEdit Complete ............. $31.45 
= ROASEEL tivenysasstaiesiennacicters $299.00 

PORANG ecccternentpeunnes $595.00 
_.. SChipt DEDU GET .aczessstunniens $119.99 
2 OOLBASE an cutsenceicevncraonas $79.00 

DOR lel aromndiayerneemeria $179.00 
og DOINGS PIO sexesiscciaeessnsausie $169.00 
nas DOO WIZ cag ancetecccpnreadovierta $84.95 
__ Sex, Lies and Video uu... $31.46 
__ SmalltalkAgents........ eee $695.00 
__ Software by Design... $26.95 
__ SPE S Wella cectrtianeletcitisennnnesinss $74.95 
5 OOP te ypaeeeeneniane $39.00 
__ Step-Up Installer Pack .......$219.00 
MONE TADIE cinckisenngeicocwens $150.00 
__ StoneTable Extra... $50.00 


__ StoneTable for PowerPC ...$100.00 
__ Symantec C++ for 68k......... $99.00 


__ Symantec C++ for Power 
Macintosh .....cccccceeee $349.00 
_- Symantec C+ Pre sassiins. $40.50 


__ Tao of AppleScript: BMUG’s 
Guide to Mac Scripting ..$26.95 
__ TCP/IP Scripting Addition ...$49.00 
__ Tenon Ported App. CD.......849.95 
__ THINK Pascal... $169.00 
__ Tog on Software Design......$26.95 
__ Tricks of the Mac Game 
Programming Gurus.......$45.00 
__ Visual Programming with 
Prograph CPX... $30.60 
__ VOODOO (Single pack)...$229.00 
__ VOODOO (2 pack)... $359.00 
~ VOODOO (5 pack) ...e..-.$799.00 
__ VOODOO (10 pack)......$1,369.00 
~ VOODOO (20 pack)......$2,399.00 
3 WED: WEAVING casicssevircossnctieons $ 
__ WebHead Mac Guide.......... $22.45 
__ Webmaster Macintosh.......... $26.95 
__ Wireless for the Newton. .....$31.45 


Ordering Instructions: Check off the products you want above. Fill in the subtotal, sales tax (for California residents only), and total. Shipping 
charges will be added upon order processing. All orders will be shipped via most econimical method (e.g., UPS Ground), unless you state other- 
wise. Remember to fill out your shipping, and payment information on the other side. 


Subtotal 


Sales Tax (8.25% for CA residents) 


Total 





Name 





Company 





Address 





City State/Province 
Zip/Postal Code Country 
Home Phone Business Phone 


E-Mail Address Fax 
|} Cash [J Check/Money Order Check # 
(J VISA L] MasterCard [] American Express Signature 


Card # Expiration Date 


If you are ordering a subscrip- 
tion to MacTech Magazine, are 
you a new subscriber, or are 
you renewing your subscription? 


Please fill out as completely as possible to avoid delays in processing your order. 


|| New Subscription 





Fold Here (First, so panel below covers your personal information.) 


Fold Here (Last) and Tape Closed (not staple) 
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b | Weaving 
ovides the guidance to create and maitttain web sites that are easily navigated, scaleable, and maintainable. 
ers the three major platforms for Web pages — UNIX, Windows, and the Mac — shows how to use software tools and utilities that 


e important in setting up web sites. 
arn how to install and configure Web servers, use authoring tools and converters, implement security schemes, and integrate 


ultimedia features such as sound, video, and graphics into Web pages. 
arn to organize and present the information in Web sites. Includes planning for growth, building in maintenance schemes, catering 


users’ needs, and creating a navigable, logical underlying infrastructure. SEE RELATED CATEGORY: 
st $24.95 Our Price Internet Related 


e A fast and easy guide for turning your Macintosh into a 
World Wide Web site — in a matter of hours! 
e Includes CD! 


clud 
List $29.95 Our Price “ag ~\ 









abHead Mac Guide SEE RELATED CATEGORY: ~ 
Internet Related 
at the most from the Web. 


asy-to-understand, great for beginners, and online veterans. 
cludes instructions on how to build your own home page, posting pages on the Web, and 
/oiding common HTML mistakes. 


st $24.95 Our Price 


arn C on The Macintosh Second Edition By Dave Mark 


ew revised edition. 

asy-to-understand — everything you need to start programming! 
pdated and enhanced exercises that lead you step by step. You'll learn function, variables, pointers 
atatypes, data structures, file input and output and more! 

cludes CD-ROM with or CodeWarrior™ Lite — the hottest Macintosh programming environment (including a PowerPC version). 


ist $34.95 Our Price | : SEE RELATED CATEGORY: | 


scover Programming for Macintosh 

\cludes full working version of CodeWarrior along with three online tutorial books and Dave Mark's "Learn C on the Macintosh" con- 
erted to AppleGuides. 

cludes C, C++ and Object Pascal compilers for generating 68K Macintosh code, source-level debuggers, object-oriented frameworks 
>owerPlant, MacApp), Apple’s MPW, complete online documentation and source code examples for all languages and platforms. 

he IDE software has been localized in eight languages plus English. This product is not sold as a subscription. 


ncludes a 3 month subscription to MacTech Magazine. SEE RELATED CATEGORY: 


Jur Price 


‘ogramming Primer Macintosh Vol 1 by John whittle and Judy May 


\n introduction to Macintosh programming, using C++ as the example language 
rovides realistic, easy to follow, programming examples designed to work with either - 
symantec® C++ or Metrowerks® CodeWarrior™ | 
ncludes one 3.5" disk with source code for the programming all plus numerous 
Jublic domain utilities to use with each compiler 


ist $37.95 Our Price 


DEPOT 


Veb site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 
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Check out hundreds of more products on 
our Web site: http://www. devdepot.com 
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SEE RELATED CATEGORY: 
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Macintosh Cc Programming Primer Volume : 
- Second Edition, Inside the Toolbox Using THINK C by Dave Mark and Cartwright Reed 
e Updated new edition of the Macintosh programming best seller. 
e System 7, new versions of THINK Cand ResEcit. 
e Learn how to use the resources, Maat) Toolbox and interface to Create stand-alone applications. 
e 6/2 pages. a 
List $26.95 Our Price 


Macintosh € Programming Primer Volume II 
Mastering the Toolbox Using THINK C by Dave Mark. 


e Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, and the Memory 
Manager: 528 pgs. 


List $26.95 Our Price 





Learn C++ on the Macintosh by Dave mark. SEE RELATED CATEGORY: 

e Basic syntax of C++ and object programming. 

e Learn how to write, edit, and compile your first C++ programs. 

e Features key C++ concepts such as derived classes, operator overloading, iostream functions and more. 

e Includes a special version of Symantec C++ for Macintosh. Book/disk package with 3.5" 800K Macintosh 
disk. 400 pages. 


List $36.95 Our Price 


Macintosh Pascal Programming Primer Volume | 
Inside the Toolbox Using THINK Pascal by Dave Mark and Cartwright Reed. 


This tutorial shows programmers new to the Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to create stand-alone applications with 
symantec’s THINK Pascal. 544 pages. 


List $26.95 Our Price 





Power Macintosh ah ciara Starter Kit ee 
by Tom Thompson. ev. Environme 


e Enter the world of the PowerPC chips. elu 
e Get the scoop on the microprocessors, the RISC architecture, and how to write native Ser 

code and emulation operations to create software for the Macintosh PowerPC. 
¢ CD-ROM includes a unique compiler for writing code easily. 


List $39.95 Our Price 








Macintosh Programming Secrets 2nd edition 
By Scott Knaster, and Keith Rollin 


¢ Macintosh Programming Secrets is divided in two parts. 
Part 1, "Concepts and Ideas", discusses the evolution of the Macintosh and the standards, 
customs, and software that shape the system as well as the Macintosh user interface. 


Order Toll-free Part 2 “Technical Adventures", presents the skeleton of an application, and then builds upon 
that framework to describe how to: ¢ Create fancy dialogue boxes « Utilize the new 32 bit 
(800-622-3381 QuickDraw developments Track the mouse with "marching ants" e Manage multiple windo 


strangest spinning cursor. 
List $31.95 Our Price 


with the Window manager e Copy files within a program e Install the worlds 









Can’t find what you’re looking for? 


EN} ‘(POT Check our Web site: http://www.devdepot.com 1 
1-800-622-3381 © Outside U.S. 805-494-9797 © Fax: 805-494-97: 








Macintosh Programming Techniques 

by Dan Sydow (Series Editor: Tony Meadow) ~~ 

e For Macintosh programmers as well as those making the transition from DOS, Windows, 
VAX or UNIX. 

e Emphasizes programming techniques for better code — regardless of language! 

e Guides you through Macintosh memory management, QuickDraw, events and more, using 
sample program in C++. 

e Includes disk with an interactive tutorial, plus reusable C++ code. 


List $34.95 Our Price 










More Mac Programming Techniques 


e Hands-on guide and tutorial, expands on the basic foundation of programming to develop 
truly powerful applications. 

e Take a detailed look at the units of a Macintosh program — from the INITs to custom controls. 

e Packed with solid tricks and techniques. 

e Learn file resources from the ground up, and how to build custom menus, add custom con- 
» trols, including buttons, and slider controls, MDEF, CDEF resources and much more. 


List $39.95 Our Price 


get 
Bia 
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ogramming with AppleTalk by Michael Pierce 


rogramming with AppleTalk is the hands-on guide to Bersted and working with ane 

dics covered include: 

ow to create applications and system extensions that run with Apple talk. 

ppleTalk protocols and the protocol stack, transport media, the Preferred AppleTalk Intefrace, and the storage management. 
umerous working code examples walk you through using RDEV, INIT, NBP, ATP, and ADSP You will also learn the use of: 
synchronous, and asynchronous calls, How to avoid heap fragmentation, And how to configure a Chooser Interface. 


ist $45.00 Our Price 


A Fragment of Your Imagination by Joe Zobkiw 


e Packed with useful code fragments for the Macintosh and Power Macintosh. 

e Hard to find information about techniques used to structure and build fat, safe fat, and 
accelerated code resources. 

e All code is reusable and is provided on the disc, along with Metrowerks 
Code Warrior Lite. Book/CD- ROM, 528 pages. 


List $39.95 Our Price $35. 





ogramming QuickDraw 


earn to build color pictures on the Mac 5 ams Sa, 
earn to maintain the highest degree of compatibility for you applications across the Mac platform ¥ % 
earn to perform sophisticated image processing operations with CopyBits( ) and CopyDesk( ) a | a 
es Feel Good 
-earn to enable your applications to take advantage of QuickDraw compliant graphics hardware about Your 
And accelerators. vs purchase! ss 
; : ee ° 
List $26.95 Our price eran 
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Optimizing PowerPC Code: Programming the 
PowerPC in Assembly Language 
e Take full advantage of the potential of the PowerPC by mastering the Assembly 


Language techniques. - 
e Learn to produce faster more robust software! 


List $39.95 Our Price $35.96 


Inside Macintosh®: PowerPC Numerics 
by Apple Computer, Inc. 


e Describes the floating-point numerics environment provided with the 
first release of PowerPC processor-based Macintosh computers. 
e Provides a description of the IEEE standard 754 for binary floating-point arithmetic., and how RISC Numerics compiles wit 
e Shows programmers how to create floating-point values and how to perform operations on floating-point values in high-le 
languages such as C and in PowerPC assembly language. 


List $28.95 Our Price $26.00 





Inside Macintosh®: PowerPC System Software by Aole Computer, Inc. 


¢ Describes the new process execution environment and system software services provided with the first version of the syste 
software for Macintosh on PowerPC computers. 

e Contains information to write applications that can run on the PowerPC. 

¢ Shows how to make your software compatible with the new run-time environment provided on PowerPC-based Macintosh 
computers. It also provides a complete technical reference for the Mixed Mode Manager, the Code Fragment Manager, and 
the Exception Manager. 


List $24.95 Our Price $22.45 
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AppleScript Finder Guide, English 
Dialect by Apple Computer, Inc. 


e Provides definitions for Finder object classes and commands. 
e Write, record, or run scripts that trigger the same desktop 
actions that you trigger using the keyboard and mouse. 


List $19.95 Our Price $17.95 SE 






' Finde 






AppleScript Language Guide, the scope of script variables and properties declared at c 
by Apple Computer, Inc. u ferent levels in a script, and inheritance and delegation 


. among script objects. 
e A complete reference for anyone using AppleScript to modify List $29.95 Our Price $26.95 
existing scripts or to write new ones. | 


e Contains useful information for programmers who are work- 
ing on scriptable applications or complex scripts. 

e Features detailed definitions of AppleScript terminology and AppleScript Scripting Additions Guid 
syntax in the following categories: Value classes, commands, by Apple Computer, Inc. 
objects and references to objects, expressions, control state- 
ments, handlers, and script objects. 

e Includes many sample scripts, discusses advanced topics 
such as writing scifi andere for script spricalione , List $18.95 Our Price $17.05 





e Use the standard scripting additions commands. 
e Write scripting additions. SEE RELATED CATEGORY 
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Danny Goodman’s AppleScript Handbook Second 
Edition by Danny Goodman 


e Customize and extend the capabilities of any Macintosh computer — no 
programming experience needed! 

e Learn to use scripts to enhance the Macintosh environment, automate many 
processes, link data between applications, and much more. 

e All-new examples showing how to integrate AppleScript with the Finder, 
spreadsheets, desktop publishing programs, graphics applications, databases, 
telecommunications programs, utilities, and HyperCard. 

e Includes 3 1/2" disk with over $100 worth of software, including 
AppleScript 1.1, valuable utilities, and powerful, ready-to-use scripts. 


List $39.00 Our Price SEE RELATED CATEGORY: SEE RELATED CATEGORY: 
° 3 Tools, Libs & Utilities 





SEE RELATED CATEGORY: 


oplied Mac Scripting e Harness the capabilities of a wide variety of Macintosh 
warn to désicn and develop powertul Sonor applications into the integrated productivity tools. This 
d PP C includes such things as the newspaper script which combines 


ey 
ee Applescript ene eS ru miles the power of SITcomm, MacWrite Pro, and FileMaker Pro, or 
aceSpan Application Builder, Scripting PlainTalk and System 7.9... HuaroPress 


ands on tutorial shows you how to automate your Macintosh | | 
activities by learning how to use the AppleScript and Frontier List $34.95 Our Price 
scripting environments. 


e Tao of AppleScript: BMUG’s Guide to Macintosh Scripting, 
acond Edition by Derrick Schneider & Hans Hansen 
\ complete, natural introduction to AppleScript programming essentials. 

earn to customize applications, automate tedious tasks, and create programs without having to 


se a complex programming language. 
ncludes 2 disks containing AppleScript, QuickTime, Stuffit Lite, ResMover, and other helpful utilities. 


oaded with practical examples for easy learning 
| | SEE RELATED CATEGORY: 
ist $29.95 Our Price : 





criptBase™ by Main Event Software 

\ database for storing persistent objects to be made available for access to AppleScript, Apple's system-level user scripting lan- 
juage for controlling applications on Macintosh® computers. 

Nnce installed, the database becomes part of the AppleScript system, adding a host of commands to the basic AppleScript vocabulary. 
Retrieving the objects is simple using AppleScript’s natural-language syntax and structure. Objects stored and retrieved in ScriptBase 
an be accessible any time from any script on the user’s computer. These objects can be of any type, including numbers, character 
strings, lists, records, scripts, and references to disks, files, folders, as well as abstract raw data, to name just a few. 

ScriptBase can be used to maintain system-wide settings, such as sets of preferences, paths to frequently-used files or folders. 


omplex installations can be made easier by organizing data and scripts within the database's structure. 
SEE RELATED CATEGORY: 


Dur Price stinc 


he Complete AppleScript Handbook by Danny Goodman 


aster AppleScript with the definitive book/disk toolkit. This self-contained toolkit teaches you Applescript from the ground up 
oviding you with tools you need to automate tasks and integrate Macintosh applications. This book explains in detail all commands 
d usage of the AppleScript language including: " 

Issuing command e Describing objects © Working with values, variables, and expressions ¢ Using if-then constructions, loops and 
broutines e Error checking and debugging « Scripting Finder-level processes e Using AppleScript with third party applications 


List $35.00 Our Price SEE RELATED CATEGORY: 


POT 


eb site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 
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The Complete HyperCard® 2.2 Handbook Fourth Edition 
by Danny Goodman 

© The biggest-selling programming Mac book. 

e Learn to build working applications using the latest version of HyperCard. 

¢ Covers text, painting tools, extension commands (XCMDs), scripting in HyperTalk, 


and more. SEE RELATED CATEGORY: 
List $35.00 Our Price 







HyperTalk® 2.2: The Book Second Edition SEE RELATED CATEG 
4 |__ Scripting| 


by Dan Winkler, Scott Kamins, and Jeanne DeVoto side 


e The most complete, authoritative source on HyperTalk 2.2 programming and troubleshot 
Covers each language element of HyperTalk 2.2 (including the odd quirk or bug). 


List $35.00 Ours Price 








HyperCard Stack Design py Apple computer, Inc. 


HyperCard Stack Design Guidelines is an essential book for everyone who creates Apple® HyperCard 
stacks. Included are illustrated discussions of: 


¢ Guidelines for stack development-audience evaluation, subject matter requirements and 
constraints, mode of presentation, and testing 
e Navigation, the importance of making sure users can get around in your stacks 
¢ Graphic Design and illustration- including the use of grids to determine card and background layout 
e Text in stacks- placement, readability, and special considerations when writing for the screen 
e Music and sound in stacks-as subject matter, reinforcement, entertainment, alert mechanism, 
or transition . SEE RELATED CATEGORY: 


List $21.95 Our Price 





Tog on Software Design by Bruce “Tog” Tognazzini 


Respected industry futurist, Tog, presents his vision of our technological future, detailing the Steps 
computer professionals need to take to deliver new technologies that will profit the industry and 
benefit society in general. Contains Tog’s insights on a wide range of topics from quality manage- 
ment to the meaning of standards, and responses to queries supplied by designers and developers. 


List $29.95 Our Price 





Object Oriented Program Design by Mark Mullin 


e A concise guide to the essential concepts and techniques of OOP design 

e Clarifies the key concepts of object oriented programming such as objects, classes, entities, hier 
chies, and inheritance 

e Uses typical database application to illustrate each OOP topic, to give the programmer a familiar 
of reference 


List $22.95 Our Price ' gfit® Gua, 
Y Vp 
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Penny Bauersfeld (Series Editor: ~Tony Meadow) ~ 


thorough how-to for designing software that is easy to learn ve comfortable to operate. 
ritten from the Macintosh perspective, but compatible with all platforms. 

resses user input from initial design, through prototyping, testing and revision. 

ovides tools for analyzing user needs and test responses, plus exercises for sharpening 
ser-oriented design skills. 


st $29.95 Our Price $26.95 





side Macintosh®: CD-ROM by Apple eaikaiet Inc. 
ore than 25 volumes in electronic form. 

cludes: QuickDraw™ GX Library, Macintosh Human ites Guidelines, PowerPC System Software, Macintosh Toolbox 
ssentials and More Macintosh Toolbox, QuickTime and QuickTime Components. 

cess over 16,000 pages of information with Hypertext linking and extensive cross referencing. 


st $99.95 Our Price $89.95 


inside Macintosh®: Sound by Apple Computer, Inc. 
e Describes the parts of the Macintosh system software that allow you to manage sounds. 


© Contains information to write applications that can record and play back sounds, compress 
and expand audio data, convert text to speech, and perform other similar operations. 


List $26.95 Our Price $24.25 


side Macintosh®: Imaging by Apple Computer, Inc. 


overs QuickDraw and Color QuickDraw. 

cludes general discussions of drawing and working with color. 
Nescribes the structures that hold images and image information, and the routines that inenulete them. 
overs the Palette, Color, and Printing Managers, and the Color Picker, Color Matching, and Picture Utilities. 


ist$26.95 OurPrice $24.25 


Inside Macintosh®: QuickTime by Apple Computer, Inc. 

e For developers who want to create applications that use QuickTime, the system software 
. that allows the integration of video, animation, and sounds into applications. 

e Describes all of the QuickTime Toolbox utilities. 


e Provides the information you need to compress and decompress images and image sequences. 


List $29.95 Our Price $26.95 


side Macintosh®: QuickTime Components by Apple Computer, Inc. 
vers how to use and develop QuickTime components such as image compressors, movie 
trollers, sequence grabbers, and video digitizers. 


t $34.95 Our Price $31.45 


( 


side Macintosh®: QuickDraw™ GX Programmer’s Overview 

Provides an introduction to QuickDraw™ Gx, providing an overview of the QuickDraw GX environment from a developer's perspective. 
ntroduces the QuickDraw™ GX programming and runtime environments, the relationship between QuickDraw GX and the rest of 
he Macintosh® systems software and the relationship between QuickDraw GX and Macintosh applications. 

Learn the key elements of QuickDraw GX programming, data structures, object types, and functions used most frequently by 
QuickDraw GX developers are also covered. 

Provides a series of practical examples demonstrating how to approach programming with QuickDraw GX. 


List $24.95 Our Price $22.45 
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Inside Macintosh®: QuickDraw™ GX Graphics 
by Apple Computer, Inc. 
¢ Shows how to create and manipulate the fundamental geometric shape 
QuickDraw GX to generate a vast range of graphic entities. 
e Demonstrates how to work with bitmaps and pictures, and specialized 
QuickDraw GX graphic shapes. 


List $26.95 Our Price 


Inside Macintosh®: QuickDraw™ GX Objects 
by Apple Computer, Inc. 


Introduces QuickDraw GX and its object structure, and shows programme 
how to manipulate objects in all types of programs. = 


List $26.95 Our Price 





Inside Macintosh®: QuickDraw™ GX Printing by Apple computer, inc. 


e Essential for any developer whose QuickDraw™ GX application supports printing. 
¢ Shows how to support the new printing features of QuickDraw GX, including desktop printers and expandable printing dialog b 
e Shows how to use printing-related objects to add custom ae to printing dialog boxes and to create custom page formats. 


List $26.95 Our Price 


Inside Macintosh®: QuickDraw™ GX Printing Extensions and Drivers by Apple Compute 


e Essential for developers who want to create extensions to the application printing capabilities of QuickDraw™ GX, or who need 

write a printing device driver that works with QuickDraw GX. 

e Describes how to create printing extensions and printer drivers, and provides a complete reference to the messages, functions, 
resources that they use. 


List $29.95 Our Price 


Inside Macintosh®: QuickDraw™ GX Typography by Apple computer. inc. 


e Essential for developers who use QuickDraw™ GX to manipulate text. 

e Shows how to use QuickDraw GX objects to handle.all kinds of text — from plain, unstyled text to complex, mixed-direction and 
multi-language text with sophisticated stylistic and typographic variations. 

e Shows how to create and manipulate the three different types of text shapes pele by QuickDraw GX including text shapes 
glyph shapes, and layout shapes. . 


List $29.95 Our Price 


Inside Macintosh®: QuickDraw™ GX Environment and Utilities by Apple Computer, Inc. 


e Companion to QuickDraw™ GX Objects. 
e Contains programming information useful to any a ae QuickDraw GX applications, 


QuickDraw to QuickDraw Gx. 
List $29.95 Our Price 


3D Graphics Programming Using QuickDraw 3D 

by Apple Computer, Inc. 

e Incorporate spectacular 3D graphics into your applications. 

e Explore QuickDraw 3D, a revolutionary graphics extension to the Mac OS for Power 
Macintoshes. 

e CD contains the complete QuickDraw 3D system itself and a complete database of the 
QuickDraw 3D API, allowing you instant access to the hundreds. of graphics calls via a fast view- 
ing engine. Book/CD-ROM, 640 pages. 


List $39.95 Our Price 
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Game Machine v1.2 by Virtually Unlimited 
pate lightning-fast 3D arcade games and interactive multimedia applications. 
a-fast rendering — 15 frames per second on a 14° monitor completely texture-mapped, with a PowerMac 6100/60 
bate full virtual" 3D worlds with six degrees of freedom, free-form texture mapping, shading, material and light properties, 
nvex/cave polygons with unlimited vertices, unlimited light sources, dynamic hidden surface removal, special graphic modes for 
pt full-screen animation, collision detection, explosion simulation, 3D data importing. | 
ple easy-to-use interface. Runs on all Macs! Works with CodeWarrior. 


r Price $299.00 + license. 


cks of The Mac Game Programming Gurus 

br beginning to expert game programmers 

omplete overview of all the necessary components of game programming on the Macintosh. 

acked with valuable tools, utilities, sample code, CodeWarrior™ Lite and game demos. 

uickDraw 3D and Power Mac optimization and inside info on how Glypha Ill was created. 
ndreds of tried-and-true tricks, tips, and insider secrets from well-known Mac game programming experts 


st $50.00 Our Price $45.00 ; 
Sex. Lies and Video Games Black Art of Macintosh Game 
, Programming: by; Kevin Tieskoetter. 


by Bill Hensler 7 
- learn-by-example tutorial on the ins and ¢ Develop your own 3D games In C on the Mac. 
outs of Mac arcade-style game program- ° see eee files for both Symantec C 


ming in C. 
e Features game theory, sprite animation, e Create freeform texture-mapped games and polygon 
graphics 


sound, and interaction techniques. | | | 
e A must-read for serious programmer's e Control dynamic source code-all compatible as native 
to the Power Mac 


and hobbyists alike. tlle 
7 . e Write directly to the screen, bypassing QuickDraw 


List 34.95 Our Price $31.46 : 
List $39.99 Our price $35.99 


ickTime Official Guide for Mac oe 


ncludes step by step lessons and hands on advice to help you get the most out of QuickTime 
ustomize the way you play QuickTime movies 

Digitize your own video 
ut and Paste clips and add tracks to movies } 
ith CD that includes QuickTime 2.0, VideoShop 2.0.3, QuickFLIX 1.1.1, and MoviePlayer 2.0 


ncorporate sound, music, and MIDI support in your movies 
dited by Don Crabb LATED CATEGORY: 


ist $49.50 Our price $45.00 
uickTime Starter Kit For The Macintosh by Robert A. Lettieri & Judith Stern 





















Ae le 


Hes 


Loaded with tips on the best ways to bring live-action video to Mac multimedia 
CD-ROM includes QuickTime tools, movie clips, shareware, and demos of Premiere and other programs. 


List $45.00 Our Price $40.50 ELA 
aphic Gems V Edited by Alan W. Paeth 










oaded with practical tools for implementing new ideas and techniques, to offer working solutions to real programming problems. 
ontains over 40 new gems in ellipses, splines, Bezier curves, and ray tracing — displaying the most recent and innovative 
techniques in graphics programming. 

ncludes a disk with source code from all five volumes. Available in both IBM and Macintosh versions. CONTENTS: Algebra and 


Arithmetic. Computational Geometry. Modeling and Transformation: Curves and Surfaces. Ray Tracing and ‘si 
Disk! 


Radiosity. Halftoning and Image Processing. Utilities. 


List $49.95 Our Price $44.95 
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e Ehhanee your software's aan + capabilties with step-by-step instructions. 
e Augment the color. support supplied with QuickDraw, and QuickDraw GX. 
e Use the Pallette Manager to get the best colors on limited — 


Plus, a sample application demonstrating ColorSync programming techniques. 
List $36.95 Our Price 





OpenDoc Programmer’s Cookbook 


e Shows you how to create OpenDoc software components, called parts editors, for the Mac OS Platfo 

e Including instructions for setting up the Macintosh Programmers Workshop (MPW) development 
environment to write OpenDoc software 

e Annotated listings of explaining the methods that implement the samplePart part editor 

e Descriptions of other sample part editors created by the OpenDoc engineering team to illustrate | 
more advanced features 

e Summary descriptions of software utilities provided with OpenDoc for the Mac OS 

e An ToencOn to the peel Object Model (SOM) underlying OpenDoc 





Essential OpenDoc Inside CodeWarrior 9 
¢ Gives an in-depth look at the technical issues of OpenDoc ® Includes CodeWarrior IDE User's Guide. , 
e Explores the three core technologies that support it’s e This is the printed version of the documentation provide 
functionality - SOM, OpenDoc’s storage mechanism, and on the CD. 
the Open Scripting Architecture (OSA). ¢ Covers CodeWarrior, the debugger, and associated tool: 
e Also examines CyberDog, a set of OpenDoc part editors that Our Price 


‘ | SEE RELATED CATEGORY: 
provides access to Internet services and offers compelling 


example of the power of OpenDoc development 
List $39.95 Our price 


Dev. Environments 


Inside PowerPlant Manual 


ResEdit™ Complete, Second Edition _ © Create PowerPlant applications using the 

by Peter Alley and Carolyn Strange CodeWarrior IDE and PowerPlant Constructor, 
ie ; e Full descriptions of major PowerPlant classes 

e Customize every aspect of your interface form : ounces 


creating screen backgrounds and icons to cus- 
tomizing menus and dialog boxes. 608 pages. 
Book/disk package. 


List $34.95 Our Price 


e Included are the PowerPlant Constructor Mani 
including View, TextTraits and Custom Types e 
ing, and PowerPlant Library Reference, coverii 
all classes and functions in PowerPlant. 





OpenDoc Programmer’s Guide by Apple Computer, Inc. 


e The official reference for the implementation of OpenDoc on the Mac OS. - 
e Describes the component software revolution and explains how to develop for it on the Mac OS platform. 


e Accompanying CD-ROM contains a complete reference to the OpenDoc programming interface, and an extensive collection of 
tested, reusable sample code. 


List $44.95 Our Price _ G++ Programming with CodeWarrior by Jan L. Harrington 


e Beginning OOP for the Macintosh and Power Macintosh and Mac OS compatible: 
e Learn object-oriented programming techniques using C++ as the example langu 
and eli and CodeWarrior as the example ee 


Our Price N SEE RELATED CATEGC 
Dev. Environme: 
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List $35.95 Our Price 








Check out hundreds of more products on 
our Web site: sti devdepot.com 
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e Add nereeiality to the Mac by I aLieuet default icons, the text of menus and elalgg t boxes, cursors, 
pointers and more. : : 
e Disk features ResEdit, plus lots of sample resources 


List $24.95 Our Price $22.45 





C++ Programming W/MacApp by David Wilson, Larry Rosenstein & Dan Shafer 
e Learn the secrets to unlocking the power of MacApp®, Apple’s development environment for C++ 
e Learn to design complex windows and views using the ViewEdit tool 

e Learn to support multipage text and graphics with only five lines of code 

e Learn to support Undo for menu commands and drawing operations that use the mouse. 


List $34.95 Our Price $31 46 sae 






)gramming in Symantec C++ for the Macintosh by Judy May and John Whittle 
introduction to object-oriented programming, the C++ language, and Symantec C++ for the Macintosh. 

eat for both programmers and beginners alike. | 

overs everything from the basics to advanced features of Symantec C++. 

cludes helpful examples of C++ code that illustrate object-oriented programs. 


st $29.95 Our Price $26.95 





mantec C++ Programming by Neil Rhodes & Julie McKeehan 
antec C++ Programming for the Macintosh is a tutorial for getting up and running in the Symantec C++ environment, while 
stering the techniques of object-oriented programming. ' 
xplore the Symantec C++ environment, from debugging a program and using resource utilities to building applications and 
reating objects 
Nesign programs for compatibility with multiple application frameworks 
earn how to use the new Visual Architect, Inspector, and templates. 


st $45.00 Our Price $40.50 
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Includes CodeWarrior Lite, and Full paeree of PowerPlant™. 
The best information on Metrowerks CodeWarrior, giving full coverage to the Gold Edition. 
CD includes Code Warrior Lite. SEE RELATED CATEGORY: 


List $39.95 Our Price $35.95 





Jan Shafer Presents the Power of Prograph CPX : 
Master the revolutionary graphical object-oriented programming language. Order Toll-free 
» Step by step course through three interrelated projects of increasing complexity. 800-MACDEV:1 
Learn Prograph language, CPX classes and object editors. a (800-622-338 |] 


Includes disk with all code in the book. 


List $49.95 Our Price $44.95 
Visual Programming with Prograph CPX 
by Scott B. Steinman and Kevin G. Carver 
e An introduction to the language and a guide for advanced users, for both 


Macintosh and Windows-based machines. 


List $34.00 Our Price $30.60 









Can’t find what you’re looking for? 
Check our Web site: = /www.devdepot.com 
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Mastering the THINK Class Library by Richard Parker 

e Provides a thorough examination of symantec’s extensive Class Library and the Visual Architect. 

e A complete description of the structure and operation of the TCL includes explanations of all code 
generated by the Visual Architect, any necessary Custom code, and the operation of this code. 

e Visual Architect tutorials provide you with a step-by-step approach for simplifying the development 
of complex Macintosh applications. 496 pages. : 


List $29.95 Our Price 


SEE RELATED CATEGORY: 
Dev. Environments 





Macintosh OLE2 Programmer’s Reference: 
Working with Objects 


¢ Complete reference to the extensible protocol of Object Linking and Embedding, version 2.01 fe 
Macintosh System 7. 

e Describes the visual and interactice interfaces that support the component objects. 

e Provides details of the OLE 2.01 for the Macintosh user Interface, addresses the issues of obje Je 
Class registration, shows how to implement the drag and drop objects from one 
application to another, covers the interface that exposes the basic embedding 
functionality, includes descriptions of API functions and more! 


List $44.95 Our Price 
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Danny Goodman’s Apple Guide Starter Kit 


by Danny Goodman and Jeremy Joan Hewes. 


e Create your own Apple Guide databases quickly and easily, without having to learn a scripting 
language, write coded files, or use several different files and programs 

e Includes advice and tips on how to design a good Guide, from planning and creation through 
testing, revising, and indexing. Book/disk, 320 pages. 


List $34.95 Our Price 


MacsBug Reference & Debugging Guide For macsBug version 6.2 
by Apple Computer, Inc. 


e MacsBug is an assembly-language-level debugging too! 

e Macros, templates, dcmds, and other resources for making debugging easier 

e Macintosh memory management and the operating system as they relate to low level debugging 
¢ How to display and set memory and process registers 

¢ Disassemble memory, and set execution breakpoints 





e Discipline, a tool for testing the validity of toolbox parameters AppleGuide Complete 
¢ Debugging strategies you can use to find and cure common bugs by Apple Computer, Inc. 
e Includes MacsBug 6.2. e Covers Guide Maker, the software you use to bu 


List $34.95 Our Price and test guide files. 
” e Learn about the complete cycle of designing as 
as advanced topics such as scripting and codin 


Programming For The Newton: Software guide files. Book/CD-ROM, 544 pages. 


Development using NewtonScript | List $39.95 Our Price 
by Julie McKeehan and Neil Rhodes. Foreword by Walter R. Smith cont 


E 
e An indispensable tool for Newton programmers. 
e Includes disk with sample Newton application from the books, as well Tools, Libs 
as demonstration version of Newton Toolkit (NTK) — the complete 


development environment for the Newton®, ' = 
e A Publication of AP Professional May 1994, Paperback, 393 pp. 5 Oe Way, 





ry % 
List $29.95 Our Price i : 2 > 
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Complete info on these products 
and hundreds more! http://www.devdepot 


DEPOT 


1-800-622-3381 © Outside U.S. 805-494-9797 © Fax: 805-494-976 


-com 1 








SEE RELATED CATEGORY: 
Tools, Libs & Utilities 


al World AppleGuide For The Mac 


introduction to AppleGuide for programmers. It explains its design and 
ction, plus how to design your own guides using AppleScript. 
ludes a disk of sample AppleGuides for AppleGuide-compliant applications. 


st $39.95 Our Price 








Wireless For The Newton: Software 


Development for Mobile Communications 

by Julie McKeehan and Neil Rhodes 

e Learn to develop Newton® software on the Macintosh. 

e Hands-on Newton environment training with sample code 

e Includes disk with sample source code for a Newton application, as well as demonstration NTK™ — 
the complete development environment for the Newton®. 


List $34.95 Our Price 





pgramming for the Newton Using NS BASIC 

ohn Schettino & Liz O’Hara 

ogram on Macintosh, Windows-based PC, or on the Newton itself. 
raight-forward “programming by example” approach — you'll be writing Newton 
ograms right away. 

cludes 3.5" disk containing Demonstration NS BASIC and over fifty example programs. (Newton not included) 


st $35.95 Our Price 





ofit From Experience by Gil Amelio and William Simon 
tten by the new CEO of Apple 


he story of the transformation of National Semiconductor — how Amelio and his management team took it 
om it’s worst loss in 30 years to the highest earnings in it’s history ¢ Includes: 6 core business issues and 
hy they are critical to success « The TEAM program ¢ 10 personal attributes to strive for e Amelio’s 
tuidelines for General Managers ¢ Attributes to look for when hiring. List $24.99 Our price 





The Mac Bathroom Reader by owen Linzmayer 


eGet the straight dope on the most interesting people, products, and the events in the Mac scmariuny 
eAmaze your friends with your knowledge of fascinating Apple facts 
eWon’t improve your Mac skills, but it will will help you impress your friends with useless Mac trivia. 


List $12.99 Our Price 


PCI System Architecture, Third Edition by mindShare 


Describing revision 2.1 of the Peripheral Component Interconnect (PCI) bus speci- 
fication, this book explores PCl’s relationship to the rest of the system. It includes 
an in-depth treatment of PCI to PCI bridges, the PCI BIOS, the 66MHz PCI bus, 


and more. 592 pages. List $34.95 Our Price 





PowerPC System Architecture 
by MindShare Inc. and Tom Shanley 


e Describes the hardware architecture of the PowerPC systems, providing clear, concise explanation of 
the PowerPC specification, the template upon which all PowerPC processors are designed. 

e Includes the specs for both the 32 and 64 bit implementations including © supervisor privilege level 
facilities ¢ logical memory addresses e I/O and memory mapped I/O © address translation 
for segments, pages, and blocks e virtual paging interrupts. 


List $34.95 Our Price 


POWERPC 
SYSTEM 
ARCHITECTUR 












Check out hundreds of more products on 
our Web site: http://www.devdepot.com 
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ony With is Qasik Draw . 


vseomallii dl ca a Inside Macintosh®: Networking — 
a eel 1 Meat © by Apple Computer, Inc. 

LEST = Describes how to write software that uses AppleTalk ia prol 
e Describes the components and organgaion: of AppleTalk and how tc 


gah Me eR 





Inside Macintosh®: AOCE 


Application Interfaces 
by Apple Computer, Inc. 


e Shows how your application can take scenes of the 
system software features provided by PowerTalk system 
software and the PowerShare collaboration servers. 

e Add electronic mail capabilities to your application, 
write a messaging application or agent, store infor- 
mation in and retrieve information from PowerShare 
and other AOCE catalogs. 

e Add catalog-browsing and find-in-catalog capabili- 
ties to your application, write templates that extend 
the Finder's ability to display information in 
PowerShare and other AOCE catalogs. 


-e Add digital signatures to files or to any portion of a 


document, and establish an authenticated messaging 
connection. 


List $40.45 Our Price 


Inside Macintosh®: 


Interapplication Communication 


by Apple Computer, Inc. 


Shows how applications can work together. How your 
application can share data, request information oF ser- 


with remote databases. 
List $34.95 Our Price 


Inside the Macintosh 
Communications Toolbox 
by Apple Computer, Inc. 


e The definitive reference to the Macintosh 

Communications Toolbox, an integral part of the 
system 7 Macintosh Toolbox that enables developers 
to create communications applications or add com- 
munications features to other applications. 

e Describes all of the routines that provide programmers 
with standard access to important communications 
services and in addition enables programmers to 
extend the reach of the Macintosh into non-Apple 
environments. 


List $24.95 Our Price 


_ 









Can’t find what you’re looking for? 
Check our Web site: si Www. devdepot.com 


select‘an AppleTalk protocol. 


e Provides the complete application teres to all AppleTalk protocol 


including ATP (AppleTalk Transaction Protocol), DDP (Datagram Deliv 
Protocol), and ADSP (AppleTalk Data Stream Protocol), among others 


List $29.95 Our Price 


Inside Macintosh®: AOCE Service Access 
Modules by Apple Computer, Inc. a 


e Describes how to write a software module that gives users and Power1 
enabled applications access to a new or existing mail and messaging | 
vice or catalog service. 

e Shows how to write a catalog service access module (CSAM), a mess: 
ing service access module (MSAM), and AOCE templates that allow a 
to set up a CSAM or MSAM and add addresses to mail and messages 
i List $26.95 Our Price 


Inside Macintosh®: Text by Apple Computer, Inc. 


e Describes how to perform text handling, from simple character disp 
to multi-language processing. 

e Covers Font, Script, Text Services, and Dictionary Managers, in addi 
to ea eae Text, bea and International and Keyboard Resour 


Inside Macintosh®: Devices by Apple Computer, Inc 


e Describes how to write software that interacts with built-in and 
peripheral hardware devices. 

e Learn how to write and install your own device drivers, desk 
accessories, and Chooser extensions. 

e Communicate with device drivers using the Device Manager: acces: 
expansion cards using the Slot Manager; control SCSI devices usinc 
SCSI Manager 4.3 or the original SCS! Manager. 

¢ Communicate directly with Apple Desktop Bus devices; interact wit 
the Power Manager in battery-powered Macintosh computers, and 
communicate with serial devices using the Serial Driver. 


List $29.95 Our Price 


Inside Macintosh®: X-Ret by Apple Computer, Inc. 


Macintosh X Ref; Provides programmers with a quick and easy way tc 
find the exact information they need in this definitive suite of books, (¢ 
26 volumes). It is indexed my topic, volume, chapter, and accompanyir 
page number. , 


List $19.95 Our Price 
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Life is Sweet with JAM! 
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Get JAM and enjoy success in building 
and deploying client/server and Web applications 


~< Macintosh 
In a world where requirements change ana deadlines don’t, only JAM gives you what 


you need to build powerful, completely portable client/server, 3-tier and Web applications. 
JAM’s cross-platform RAD capabilities enable you to successfully develop and deploy 
demanding applications across any platform, database, GUI or Web Browger. 


Are you willing to base your project's success on a tool that only promises portability? 
JAM lets you build great looking applications that are fully portable today. If you need to 
build serious client/server, Z-tier or Web applications, call JYACC for a free demonstration 
kit or white paper. 


Nindows 95 > 


Desktop ease with the power of a 2nd-generation tool 

Unrivaled portability between Windows® 3.1, NT, 95; Macintosh®; OS/2 Warp®; 
Character, Motif and Web Browsers 

Unparalleled database access to Oracle®, Sybase®, Informix®, ODBC and more 
Automatic SQL generation with full transaction control 

Visual repository-driven development of both client and application server 
Centralized control over application objects via inheritance 

Unique architecture for team development 

No runtimes 


oe. ee he ek 


~<- Windows 3.1, 


———" Find out for yourself how sweet life can be with JAM! 


Call 1 800 458-3315. 


Or E-mail: sweetlife2@jyacc.com for a free demonstration kit or white paper. 
e 4 Visit our Web site at http://wwwjyacc.com 
For international inquiries call: 1-212-267-7722 or FAX 1-212-608-6755 
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developers for over 18 years 
JAM is a registered trademark of JYACC, Inc. Other trademarks are the property of their respective owners. 











The future is definitely not running away from \ 
Java™ tools for CodeWarrior 9 premiering May 13 in San Jose, CA 





CodeWarrior, the award-winning S a Te 
1 
Mac-nosted GevE/OP Ment SUILE NOW 7 


includes full-featured JaVa” tools! 


i File Edit Search Project Tosls Window 


CodeWarrior 9 introduces the Java 
compiler, nhey aielerenge plug-ins, 
source-level debugging. and integrated 
Java class browsing! Plus a full-featured 
Java development environment that you 


could only expect from CodeWarrior. 
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| 
CodeWarrior : 
: a / 
x : 
CodeWarrior Gold 9 Discover Programming” with Java 
| 
eos ltiple OS development Learn how to program using Java. Designed 
Y | ay 
OM tle Cf Cre for both novice and experienced programmers, 


Discover Programming with Java takes you 


Step-by-step throu gi the learning process. 


‘tis eat 
NE aici gems seem. 
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For More Information Call 1-800-377-5416 
System requirements: Macintosh 68020, 68030 or 68040, or Power Macintosh 601, 603 or 604 processor. Minimum of 8MB RAM. iy 
CD-ROM drive to install software. ©1996 Metrowerks Corporation. All rights reserved. All products are trademarks of their respective companies. 
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